---
title: "Retrieve state card details"
method: GET
path: "/api/state_card_details"
tags: ["Card Details"]
---

# Retrieve state card details

`GET /api/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

- `Authorization` string, required

## Response `200`

A list of state card details.

- object
  - `data` object[]
    - `state` string — Two-letter state code (e.g., "MA" for Massachusetts), as defined by USPS.
    - `bin` string — A unique identifier that helps determine the issuer of a payment card and guides how transactions are processed.
    - `pan_lengths` integer[] — A list of acceptable PAN lengths for the state.

## Other responses

- `401` — __Unauthorized__ Missing valid API key.
- `500` — __Server Errors__ Something went wrong on Forage's servers. Try again.

---

[API](https://skmtc.dev/joinforage/apis/forage-payments-api.md) · [All operations](https://skmtc.dev/joinforage/apis/forage-payments-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/joinforage/forage-payments-api/revisions/4b7212706fae/schema)