v1
latestOpenAPI 3.0.02026-07-244352379.2 KBRetrieve state card details
This endpoint returns a predefined list of U.S. states, associated card BINs, and acceptable PAN (Primary Account Number) lengths. The data is static and designed for consumption by SDKs and partner integrations to facilitate client-side validation of state-specific card details.
Each entry in the response includes a two-letter state code, the corresponding BIN, and an array of valid PAN lengths for that state.
This endpoint is particularly useful for ensuring consistency and accuracy in front-end validation processes.
Headers
An OAuth 2.0 bearer token that validates the request. You can use either a short-lived session token if the request is coming from the front-end, or an authentication token for server-side requests. Pass the token in this header after the word Bearer and a whitespace, for example Bearer <api_key>.
Response
A list of state card details.