HomeGuidesReference↗ Forage Dashboard
Log In
Reference

Retrieve 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
string
required

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

Responses

500

Server Errors Something went wrong on Forage's servers. Try again.

Language
Credentials
OAuth2
URL
Response
Choose an example:
application/json