Batch lookup: POST /v1/bins

This endpoint returns the card data for up to 2,000 BINs in one request.

Availability

This endpoint is available on the BLAPI-500KPM plan. On other plans, the API returns the error FEATURE_NOT_AVAILABLE.

Request

Send a POST request with a JSON body. The body contains one field, numbers. This field is an array of 1 to 2,000 values. Each value follows the same rules as a single lookup.

curl -X POST "https://api.binlookupapi.com/v1/bins" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"numbers": [42467101, 123456, "abc"]}'

Response

The results array contains one item for each value that you sent. The items are in the same order as your request.

• A found BIN returns a data object.
• An unknown BIN returns the item error NOT_FOUND.
• A value that is not valid returns the item error BAD_REQUEST.

One item error does not stop the other items.

{
  "mode": "live",
  "results": [
    {
      "number": 42467101,
      "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 }
    },
    { "number": 123456, "error": "NOT_FOUND", "message": "BIN not found" },
    { "number": "abc", "error": "BAD_REQUEST", "message": "number must be an integer between 6 and 11 digits" }
  ]
}

Quota

Each value in the array uses one unit of your daily quota. If the array is larger than your remaining quota, the API returns 429. In this case, the API does not use any quota. See How daily quotas work.

Security

If a value has more than 11 digits, the response shows the value as [REDACTED].