▣ 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

API key

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)

Attribute	Type	Mandatory	Description
bin	String	Yes	6–8 digit BIN/IIN to look up.

Response

Attribute	Type	Description
success	Boolean	Whether the request succeeded.
code	Integer	Numeric response code.
BIN	Object	BIN lookup result.
BIN.valid	Boolean	Whether the BIN was recognized.
BIN.number	Integer	The BIN as submitted.
BIN.length	Integer	Length of the BIN (6 or 8 digits).
BIN.scheme / brand	String	Card network (e.g. VISA, MASTERCARD).
BIN.type	String	`DEBIT`, `CREDIT`, or `CHARGE`.
BIN.level	String	Card tier/level (e.g. PLATINUM, DANKORT).
BIN.is_commercial	Boolean	Whether it's a commercial/business card.
BIN.is_prepaid	Boolean	Whether it's a prepaid card.
BIN.currency	String	Card's billing currency.
BIN.issuer	Object	Issuing bank — name, website, phone.
BIN.country	Object	Issuing country — name, flag, ISO codes, currency, region, language.

Query parameters

Name

Type

Description

binREQUIRED

string

—

▣ 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.