Check a Card Number for Compromise

Retrieve a list of recovered payment card numbers

Returns a list of compromised payment card numbers matching a partial card number provided to the call. The partialCardNumber field in the body should contain the first 8 digits of the card number being checked.

This call uses a k-anonymity algorithm to ensure that the complete card number being checked is not sent to the server in the clear. All compromised payment card numbers matching having a match on the first 8 digits will be returned in the cardsFound response, allowing the caller to then locally compare to determine if the full payment card number being checked is in the Enzoic database of compromised card numbers.

POSThttps://api.enzoic.com/v1/payment-card-exposures

Authorization

enzoic_auth

Body

application/json

partialCardNumber*string

The first 8 digits of the card number being checked.

Example: 40112322

includeRawMatchSourceboolean

If this parameter is specified and true, the results will include the raw match source inline, along with the exposure IDs. The raw match source will be the snippet of text from the breach source where the card number was found, providing additional context into what else was exposed (e.g. name, CVV, expiration date, etc.).

NOTE: Including this parameter will increase the size and significantly slow the response. Do not specify this parameter unless you actually need the original source text.

Example: true

Response

200

The response body contains the requested results.

Body

application/json

cardsFoundarray of object

An array of past exposures found for the provided card number

Request

JavaScriptCurlPython

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

Response

200

{
  "cardsFound": [
    {
      "cardNumber": "text",
      "exposures": [
        {
          "exposureID": "5f483321b7496d0008ae3073"
        }
      ],
      "rawMatchSource": "Jane Doe 4242424242424242 08/28 123"
    }
  ]
}