VeriSecDocs

Financial · API reference

BIN

Look up a BIN

GET/v2/bin/{digits}bin.lookup

Looks up the first 6 to 8 digits of a card: network, type, level, funding, issuer, country with its flag, currency, and the issuer's record in the bank directory. Fewer than 6 digits answer 400 bin_too_short; a BIN not in the tables 404 bin_not_found.

Price: 0.002 credits per successful call.

Path parameters

digitsstringrequired

The first 6 to 8 digits of the card number.

Returns

The BIN was found.

Show the BinRecord fields
binstringrequired

The first 6 to 8 digits.

networkstring

Visa, Mastercard, American Express, Discover…

typestring

Debit, Credit…

levelstring

Classic, Gold, World…

issuerstring

The issuing bank's name.

countrystring

Issuing country, ISO 3166-1 alpha-2.

country_namestring
country_code3string
flagstring

Flag emoji.

flag_urlstring

The country's flag (SVG), relative to the API base.

bankobject or any

The issuer in the bank directory, with logo. Returned by GET /v2/bin/{digits}.

currencystring

ISO 4217.

currency_namestring
fundingstring
creditdebitprepaidchargeunknown
is_prepaidboolean
is_commercialboolean
is_reloadableboolean
categorystring
consumercommercial
issuer_countrystring
phonestring

Issuer contact, when known.

urlstring

Issuer website, when known.

sourcestring

Which tier answered.

Errors

  • 400A field is missing or not valid.
  • 401No API key, or the key is not valid, expired or revoked.
  • 402Not enough credits for this call (insufficient_credits), or the key reached its spend cap. Nothing was charged.
  • 403The key may not call this API (permission, environment or IP allow-list). Nothing was charged.
  • 404Nothing was found.
  • 429Too many requests for this key: wait Retry-After seconds. Nothing was charged.
  • 5XXThe check could not run. Nothing was charged.
Request
curl https://verisec.dev/v2/bin/424242 \
  -H "Authorization: Bearer $VERISEC_API_KEY"
Response · 200
{
  "network": "Visa",
  "type": "Debit",
  "level": "Classic",
  "funding": "debit",
  "issuer": "Aeron Fintech",
  "country": "RW",
  "currency": "RWF",
  "is_commercial": false,
  "is_prepaid": false,
  "url": "https://aeron-fintech.example",
  "source": "local+online",
  "bin": "424242",
  "category": "consumer",
  "is_reloadable": true,
  "country_name": "Rwanda",
  "country_code3": "RWA",
  "issuer_country": "RW",
  "flag": "🇷🇼",
  "currency_name": "Rwanda Franc",
  "flag_url": "/v2/flags/rw.svg",
  "bank": {
    "read": {
      "name": "Aeron Fintech",
      "country": "RW"
    },
    "resolved": {
      "profile_id": "bank_1d4e94dde9d17fc07f",
      "name": "Aeron Fintech",
      "country": "Rwanda",
      "country_code": "RW",
      "city": "Kigali",
      "address": "Aeron House, 14 Innovation Way, Kigali",
      "status": "active",
      "logo_url": "/v2/banks/bank_1d4e94dde9d17fc07f/logo",
      "flag_url": "/v2/flags/rw.svg"
    },
    "match_confidence": 1,
    "name_match": 1,
    "alternatives": []
  }
}