apyhub
Back
▣ DATA VALIDATION · FINANCE

BIN Lookup API

What it does

BIN Lookup helps you identify a payment card’s issuing details from its BIN, or bank identification number. Send a BIN in the bin query parameter and get back a response envelope with a numeric code, a success flag, and additional module blocks in the body.

Use BIN Lookup when you need to confirm card metadata before processing a payment, routing a transaction, or enriching payment-related records. It is useful in checkout flows, fraud checks, payment analytics, and internal support tools where a card prefix needs to be mapped to issuer information.

The service is intentionally narrow: the request accepts a single string field, bin, and the response is centered on a simple success envelope. That makes it easy to wire into existing payment systems without having to handle a large payload or multiple required inputs.

If you are validating card-related data or looking up issuer context from a prefix, BIN Lookup gives you the basic lookup result in a format that is straightforward to consume.

GET
BIN Lookup
https://api.eu.apyhub.com/quadlem/bin-lookup

QUICKSTART

GUIDE

Quickstart

Use the following request to look up a Bank Identification Number (BIN) and retrieve information about the associated payment card.

curl -X GET "https://api.eu.apyhub.com/quadlem/bin-lookup?bin=45717360" \
  -H "apy-token: $APY_TOKEN"

What you'll get back

A successful request returns details about the payment card, including its validity, scheme, brand, type, issuing bank, and issuing country.

{
  "success": true,
  "code": 200,
  "BIN": {
    "valid": true,
    "number": 45717360,
    "scheme": "VISA",
    "brand": "VISA",
    "type": "DEBIT",
    "level": "DANKORT",
    "is_prepaid": false,
    "currency": "DKK",
    "issuer": {
      "name": "Example Bank A/S"
    },
    "country": {
      "name": "DENMARK",
      "alpha2": "DK",
      "currency": "DKK",
      "flag": "🇩🇰"
    }
  }
}

Note: Depending on the BIN and data source, the response may include additional issuer and card metadata beyond the fields shown in this example.

TRY ITLIVE · 40 ATOMS
Loading your default key…
The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.

About this endpoint

What it does

Identifies a payment card from its BIN/IIN and returns the card scheme, brand, type, level, issuer, and issuing country.

Query Parameter(s)

AttributeTypeMandatoryDescription
binStringYes6–8 digit BIN/IIN to look up.

Response

Returns a JSON object with the request status and a BIN object describing the card -- scheme, type, level, issuer, and issuing country.

AttributeTypeDescription
successBooleanWhether the request succeeded.
codeIntegerNumeric response code.
BINObjectBIN lookup result.
BIN.validBooleanWhether the BIN was recognized.
BIN.numberIntegerThe BIN as submitted.
BIN.lengthIntegerLength of the BIN (6 or 8 digits).
BIN.scheme / brandStringCard network (e.g. VISA, MASTERCARD).
BIN.typeStringDEBIT, CREDIT, or CHARGE.
BIN.levelStringCard tier/level (e.g. PLATINUM, DANKORT).
BIN.is_commercialBooleanWhether it's a commercial/business card.
BIN.is_prepaidBooleanWhether it's a prepaid card.
BIN.currencyStringCard's billing currency.
BIN.issuerObjectIssuing bank — name, website, phone.
BIN.countryObjectIssuing country — name, flag, ISO codes, currency, region, language.
▣ COMMON ERRORS

Errors any endpoint can return

400bad_request

Required parameter missing or malformed body.

401unauthorized

API key missing, revoked, or not authorized for this service.

429rate_limited

Your plan's per-second rate exceeded. Retry with exponential backoff.

503upstream_busy

Backend temporarily unavailable. Try again in a few seconds.