Get Exposures for an Email Address

Retrieve all breaches a given email address has been exposed in

Lookup all exposures for an email address

get

Returns all credentials exposures that have been found for a given user.

Authorizations

Query parameters

usernamesarrayRequired

A list of up to 50 email addresses OR SHA256 hashes of the lowercased email addresses (recommended)

Example: usernames=[e-mail]&usernames=[e-mail]

includeExposureDetailsintegerOptional

(Optional) If this parameter is specified and non-zero, the results will include the exposure details inline, rather than just the IDs. In this case the exposures array in the response will contain an array of ExposureDetails objects

Default: 0Example: 1

startDatestringOptional

(Optional) Specifies a start date/time in ISO8601 format (e.g. 2023-06-01T00:00:00Z). If specified, only exposures which occurred after this date will be included in the response.

Example: 2023-06-01

endDatestringOptional

(Optional) Specifies an end date/time in ISO8601 format (e.g. 2023-06-01T00:00:00Z). If specified, only exposures which occurred before this date will be included in the response.

Example: 2023-07-01

Responses

200

The response contains an array of objects, one per username that was passed in. Each object will contain an array of the known Exposures for that user.

application/json

get

HTTPcURLJavaScriptPython

GET /v1/exposures-for-usernames HTTP/1.1
Host: api.enzoic.com
Authorization: Bearer Base64(your_api_key:your_api_secret)
Accept: */*

200

The response contains an array of objects, one per username that was passed in. Each object will contain an array of the known Exposures for that user.

[
  {
    "username": "[e-mail]",
    "usernameHash": "51885d3cc1b6f144455e9d25661ca34b9f945b5540b61cb41cf56381950bf50b",
    "count": 1,
    "exposures": [
      {
        "id": "57dc11964d6db21300991b78",
        "title": "funsurveys.net",
        "entries": 5123,
        "date": "2015-05-01T00:00:00.000Z",
        "category": "Manufacturing",
        "source": "Cybercrime Forums",
        "passwordType": "Cleartext",
        "exposedData": [
          "Emails",
          "Passwords"
        ],
        "dateAdded": "2016-09-16T15:36:54.000Z",
        "sourceURLs": [
          "https://www.someplace.com"
        ],
        "domainsAffected": 683,
        "sourceFileCount": 1
      }
    ]
  }
]