---
title: "BIN Lookup"
method: POST
path: "/payments/bin-lookups"
tags: ["Payments", "Insights"]
---

# BIN Lookup

`POST /payments/bin-lookups`

## Request

- Base URL: `https://api.evervault.com`
- URL: `https://api.evervault.com/payments/bin-lookups`
- Auth: HTTP basic
- TypeScript: <https://skmtc.dev/evervault/apis/evervault-api/docs/payments/bin-lookups/post.ts> (a function with typed inputs; its response is checked against the schema)

Performs a BIN lookup for the provided card number and retrieves associated information such as the card brand, country, issuer, and more.

## Request body

- object
  - `number` string, required: The card number for which the BIN lookup is being requested. It can be a plaintext Card number (FPAN) / Network Token number (DPAN), an encrypted Card number / Network Token number or simply just a BIN (6-10 first digits of a Card Number) for range lookup.
  - `externalCustomerReference` string: An optional reference of your choice, such as a correlation ID, that is attached to the request. The reference will be visible in your logs. Must be between 1 and 255 characters.

## Response `201`

Returns BIN details for the provided card number.

- BinLookup
  - `id` string, required: The unique identifier for the BIN lookup
  - `brand` 'visa' | 'mastercard' | 'american-express' | 'discover' | 'diners-club' | 'jcb' | 'unionpay': The card brand associated with the payment card.
  - `funding` 'debit' | 'credit' | 'prepaid' | 'deferred-debit' | 'charge': The card funding type specifies the method by which transactions are financed.
  - `segment` 'consumer' | 'commercial' | 'business' | 'government' | 'payouts' | 'all': The card segment indicates the primary market or usage category of the card.
  - `country` string, iso-3166-1-alpha-2: The country associated with the card.
  - `currency` string: The currency associated with the card (ISO 4217)
  - `issuer` string: The name of the issuer bank
  - `type` 'null' | 'card' | 'network-token', nullable: Type of card range identified during the lookup
  - `productName` string: The name of the product associated with the card
  - `fastFunds` CardFastFunds: Specifies the availability of instant payment capabilities for card transactions, indicating whether funds can be transferred immediately both within the same country and across international borders.
    - `domestic` boolean: When true, indicates that instant payments are supported for transactions within the same country/domestic market. This allows for immediate funds availability for local transfers.
    - `crossBorder` boolean: When true, indicates that instant payments are supported for international transactions between different countries. This enables immediate funds availability for cross-border transfers.
  - `matchPrecision` number: Indicates how many leading digits of the submitted BIN are confirmed by the matched data. A higher value means a more specific match. When multiple matches are found, the value represents the least precise BIN range the submitted BIN could belong to.
  - `threeDS` CardThreeDSMetadata: Metadata about 3DS capabilities, including supported versions and ACS (Access Control Server) indicators.
    - `supportedVersions` object, required: The 3DS versions supported by the ACS and DS
      - `accessControlServer` string[]
      - `directoryServer` string[]
    - `acsInfoIndicators` object[]: Array of ACS information indicators
      - `code` string: The indicator code, the following values are supported: - `authentication-available` - `attempts-supported` - `decoupled-authentication-supported` - `trustlist-supported` - `device-binding-supported` - `webauthn-authentication-supported` - `spc-authentication-supported` - `tra-exemption-supported` - `trustlist-exemption-supported` - `low-value-exemption-supported` - `secure-corporate-payments-exemption-supported` - `emvco-reserved` - `ds-reserved` **American Express only:** - `issuer-tra-exemption-supported` - `issuer-trustlist-exemption-supported` - `issuer-low-value-exemption-supported` - `issuer-secure-corporate-payments-exemption-supported` - `bridging-message-extension-supported` **Mastercard only:** - `smart-auth-direct-stand-in-only` - `smart-auth-direct` - `payment-transactions-supported` - `non-payment-transactions-supported` - `app-channel-supported` - `browser-channel-supported` - `app-acs-challenge-supported` - `browser-acs-challenge-supported` **Visa only:** - `issuer-tra-exemption-supported` - `data-only-supported` - `delegated-authentication-supported` - `digital-auth-framework-supported`
      - `indicator` string, required: The raw numeric indicator value, ranges from 01 to 99
      - `description` string: Human-readable description of the indicator
  - `createdAt` integer, required: Unix timestamp of when the BIN lookup was created

## Changes

- **2026-11-06** `8d0ca833fa04`: 6 info
  - added the new optional request property `externalCustomerReference`
  - added the optional property `matchPrecision` to the response with the `201` status
  - the response property `createdAt` became required for the status `201`
  - the response property `id` became required for the status `201`
  - …2 more
- **2025-11-18** `30ea25af4354`: 1 warning, 4 info
  - added the new `undefined` enum value to the `type` response property for the response status `201`
  - api tag `Insights` added
  - api tag `Payments` added
  - api tag `payments` removed
  - …1 more

[Operation history](https://skmtc.dev/evervault/apis/evervault-api/changes/payments/bin-lookups/post.md)

---

[API](https://skmtc.dev/evervault/apis/evervault-api.md) - [All operations](https://skmtc.dev/evervault/apis/evervault-api/llms.txt) - [OpenAPI document](https://skmtc.dev/evervault/apis/evervault-api/revisions/8d0ca833fa04?raw)