Single lookup: POST /v1/bin

This endpoint returns the card data for one BIN.

Request

Send a POST request with a JSON body. The body contains one field, number.

curl -X POST "https://api.binlookupapi.com/v1/bin" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"number": 42467101}'

Rules for the number field

• Send the first 6 to 11 digits of the card number.
• Send an integer. A string of digits is also accepted.
• Leading zeros are removed.
• The request body must not be more than 1 KB.

CAUTION: Do not send the full card number. See Never send full card numbers.

Response

A success response has the HTTP status 200. The body contains the data object. On the BLAPI-150KPM plan and the BLAPI-500KPM plan, the body also contains the meta object.

{
  "mode": "live",
  "data": {
    "bin": "42467101",
    "scheme": "visa",
    "funding": "debit",
    "brand": "VISA",
    "category": "CLASSIC",
    "country": { "code": "PL", "name": "POLAND" },
    "issuer": { "name": "ING BANK SLASKI SA", "website": null, "phone": null },
    "currency": "PLN",
    "prepaid": false,
    "commercial": false
  },
  "meta": { "longer_bin_available": false }
}

See Response fields for the meaning of each field.

Quota headers

Each response contains the quota headers. See Quota headers.

Errors

See Error codes.