Get Exposures for All Email Addresses in a Domain

Retrieve a list of all users for a given email domain who have been exposed in breaches

This call is useful if you are interested in pulling all the users for your domain who have had their email address show up in any breach in the Enzoic database. This differs slightly from the "Get Exposures for Domain" variant of the call in that it returns the specific email addresses and which breaches they were exposed in.

Note that you must have approval to pull exposures for a given domain. Contact support for approval if you receive a message that you do not have permissions to pull exposures for a given domain.

---

Lookup exposures for all email addresses in a domain

get

Returns all credentials exposures that have been found for users in a given email domain.

Authorizations

Query parameters

accountDomainstringRequired

The domain to return exposures for (e.g. “enzoic.com”)

Example: corp.co

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

pageSizeintegerOptional

(Optional) The number of results to return in a single call. The default page size is 1000 and the maximum is 1000.

Default: 1000Example: 500

pagingTokenstringOptional

(Optional) For each call to the API, if there are additional pages of results available then a pagingToken will be returned. Pass the pagingToken in via this parameter to retrieve the subsequent page of results. Should be left off for the initial call to the API.

Example: 598e5b844eb6d82ea07c5783

Responses

200

Exposed users for the domain were found and the requested page is in the response body

application/json

404

The domain was not found in Enzoic’s database and has no exposed users associated with it.

get

HTTPcURLJavaScriptPython

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

{
  "count": 1,
  "pagingToken": "598e5b844eb6d82ea07c5783",
  "users": [
    {
      "username": "[email protected]",
      "exposures": [
        "57dc11964d6db21300991b78"
      ]
    }
  ]
}