Query Breach Alert Subscriptions for Users

Retrieve current user breach alert subscriptions

Returns a paginated list of all user-level alert subscriptions for your account. Can be used to check if a specific user is monitored by using the usernameHash parameter.

get

/breach-monitoring-for-users

Authorizations

Query parameters

includeExtendedInfoboolean

(Optional) If this parameter is specified and true, the results will include the webhook information and custom data for each monitored user.

usernameHashstring

(Optional) If specified, the call will only check to see if this email address is monitored. It consists of a SHA256 hash of the lowercased email address to check. If this parameter is not provided, the call will instead return a list of all emails being monitored for your account.

usernameCustomDatastring

(Optional) If specified, the call will return a list of all emails being monitored for your account that were originally added with this customData value.

pageSizeinteger

(Optional) The number of results to return in a single call

pagingTokenstring

(Optional) For each call to the API, if there are more 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.

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://api.enzoic.com/v1/breach-monitoring-for-users' \
  --header 'Authorization: Basic username:password'

200

404

200

{
  "count": 1,
  "pagingToken": "5854757a7750ac6c4230f656",
  "usernameHashes": [
    {
      "usernameHash": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
      "customData": "corporate_users",
      "webhookID": "66766957431c9acc8cea2d6d",
      "webhookURL": "https://mywebhook.com"
    }
  ]
}

The response body contains the requested results.