Monitoring BINs

Setup which BIN numbers you wish to monitor

The following API endpoints allow you to add, update, delete, and retrieve monitored BINs in the Enzoic system, using your API key. Note that you will need to have BIN Monitoring added to your subscription before you can call these APIs. You will also need a webhook configured on your account to receive notifications.

Add Bank Identification Numbers to BIN monitoring

Allows you to set up a new alert subscription for one or more Bank Identification Numbers (BINs).

POSThttps://api.enzoic.com/v1/bin-monitoring

Authorization

enzoic_auth

Body

application/json

binsarray of string

An array of Bank Identification Numbers (BINs) to monitor.

Response

201

The call was successful. Your webhook will now be called whenever a credit card belonging to one of the submitted BINs is involved in a new breach.

Body

application/json

addedinteger

The number of new alert subscriptions created.

alreadyExistedinteger

The number of alert subscriptions which already existed.

Request

JavaScriptCurl

const response = await fetch('https://api.enzoic.com/v1/bin-monitoring', {
    method: 'POST',
    headers: {
      "Authorization": "basic <token>",
      "Content-Type": "application/json"
    },
    body: JSON.stringify({}),
});
const data = await response.json();

Response

{
  "added": 1
}

Delete monitored BINs

Allows you to delete alert subscriptions for one or more Bank Identification Numbers (BINs).

DELETEhttps://api.enzoic.com/v1/bin-monitoring

Authorization

enzoic_auth

Body

application/json

binsarray of string

An array of Bank Identification Numbers (BINs) to stop monitoring.

Response

200

The call was successful. The provided BINs will no longer be monitored.

Body

application/json

deletedinteger

The number of monitored BINs deleted.

notFoundinteger

The number of provided BINs which were not found in the monitored BINs table.

Request

JavaScriptCurl

const response = await fetch('https://api.enzoic.com/v1/bin-monitoring', {
    method: 'DELETE',
    headers: {
      "Authorization": "basic <token>",
      "Content-Type": "application/json"
    },
    body: JSON.stringify({}),
});
const data = await response.json();

Response

{
  "deleted": 1
}

Retrieve list of currently monitored Bank Identification Numbers (BINs)

Returns a paginated list of all monitored BINs for your account.

GEThttps://api.enzoic.com/v1/bin-monitoring

Authorization

enzoic_auth

Query parameters

Response

200

The response body contains the requested results.

Body

application/json

countinteger

The total number of monitored BINs available across all pages. If this exceeds the requested page size, the results are paginated and a pagingToken will be present in the response.

monitoredBinsarray of string

An array of monitored BINs

pagingTokenstring

Present when there are additional pages of results available. Pass this token in on a subsequent call to fetch the next page of results.

Request

JavaScriptCurl

const response = await fetch('https://api.enzoic.com/v1/bin-monitoring', {
    method: 'GET',
    headers: {
      "Authorization": "basic <token>"
    },
});
const data = await response.json();

Response

{
  "count": 1,
  "monitoredBins": [
    "424242"
  ],
  "pagingToken": "5854757a7750ac6c4230f656"
}