Cards

Get Card PAN

Claims the PAN for an agent card, such as one created via the API, and returns a short-lived reveal grant. GET the reveal_url with your API key and Authorization: Bearer <reveal_token> to receive the card number, CVC, and expiration. Requires the cards:write scope. Pass the card_id returned by Create Card. This can be called only once per card; subsequent calls return an error. A vendor failure before the reveal grant is created does not consume the one-time retrieval, so that request can be retried. Revoke and recreate the card if the PAN is needed again after a successful call.

post/cards/{card_id}/pan

Request

Path parameters

card_idstring uuid required

Card to act on. Use list_cards to find one.

Headers

x-entity-idstring uuid

Optional entity_id to scope requests to a specific entity.

Response

Successful Response

reveal_urlstring required

URL to fetch the card number from. GET this URL with your API key and Authorization: Bearer <reveal_token> to receive the PAN, CVC, and expiration.

reveal_tokenstring required

Short-lived bearer token for the reveal URL.

token_expires_in_secondsinteger required

Seconds until the reveal token expires.

exp_monthinteger nullable

Expiration month (1-12).

exp_yearinteger nullable

Expiration year (4-digit).

Changes

No recorded changes to this operation across all 1 revision of this API.