Sample - Stripe API
GET/v1/issuing/cards/{card}

Retrieve an Issuing card

Retrieves an Issuing card by its identifier. Use expand when you need selected nested fields, such as the virtual card's CVC, included in the response. The response contains the cardholder, card status, currency, expiration details, last four digits, and spending controls.

  • RetriesRetries up to 2×, 500ms backoff, 30s timeout.

2 parameters
cardstringrequired
The unique identifier of the Issuing card. Maximum 5,000 characters.
expandarray<string>optional
Fields to expand in the card response, including the CVC when available. Each field name can contain up to 5,000 characters.

2 status codes
200Returns the Issuing card object, including its brand, cardholder, currency, expiration details, last four digits, status, metadata, and spending controls.
brandstringrequired
The brand of the card.
cancellation_reasonstringoptional
The reason why the card was canceled.
Allowed:design_rejectedfulfillment_errorloststolen
cardholderobjectrequired
An Issuing `Cardholder` object represents an individual or business entity who is [issued](https://docs.stripe.com/issuing) cards. Related guide: [How to create a cardholder](https://docs.stripe.com/issuing/cards/virtual/issue-cards#create-cardholder)
createdintegerrequired
Time at which the object was created. Measured in seconds since the Unix epoch.
currencystringrequired
Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html), in lowercase. Supported currencies are `usd` in the US, `eur` in the EU, and `gbp` in the UK.
cvcstringoptional
The card's CVC. For security reasons, this is only available for virtual cards, and will be omitted unless you explicitly request it with [the `expand` parameter](https://docs.stripe.com/api/expanding_objects). Additionally, it's only available via the ["Retrieve a card" endpoint](https://docs.stripe.com/api/issuing/cards/retrieve), not via "List all cards" or any other endpoint.
exp_monthintegerrequired
The expiration month of the card.
exp_yearintegerrequired
The expiration year of the card.
financial_accountstringoptional
The financial account this card is attached to.
idstringrequired
Unique identifier for the object.
last4stringrequired
The last 4 digits of the card number.
latest_fraud_warningobjectoptional
Stripe’s assessment of whether this card’s details have been compromised. If this property isn't null, cancel and reissue the card to prevent fraudulent activity risk.
lifecycle_controlsobjectoptional
Rules that control the lifecycle of this card, such as automatic cancellation. Refer to our [documentation](/issuing/controls/lifecycle-controls) for more details.
livemodebooleanrequired
If the object exists in live mode, the value is `true`. If the object exists in test mode, the value is `false`.
metadataobjectrequired
Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format.
numberstringoptional
The full unredacted card number. For security reasons, this is only available for virtual cards, and will be omitted unless you explicitly request it with [the `expand` parameter](https://docs.stripe.com/api/expanding_objects). Additionally, it's only available via the ["Retrieve a card" endpoint](https://docs.stripe.com/api/issuing/cards/retrieve), not via "List all cards" or any other endpoint.
objectstringrequired
String representing the object's type. Objects of the same type share the same value.
Allowed:issuing.card
personalization_designstringoptional
The personalization design object belonging to this card.
replaced_bystringoptional
The latest card that replaces this card, if any.
replacement_forstringoptional
The card this card replaces, if any.
replacement_reasonstringoptional
The reason why the previous card needed to be replaced.
Allowed:damagedexpiredfulfillment_errorloststolen
second_linestringoptional
Text separate from cardholder name, printed on the card.
shippingobjectoptional
Where and how the card will be shipped.
spending_controlsobjectrequired
statusstringrequired
Whether authorizations can be approved on this card. May be blocked from activating cards depending on past-due Cardholder requirements. Defaults to `inactive`.
Allowed:activecanceledinactive
typestringrequired
The type of the card.
Allowed:physicalvirtual
walletsobjectoptional
Information relating to digital wallets (like Apple Pay and Google Pay).
defaultError response.
errorobjectrequired

Error handling

card must identify the card to retrieve and must not exceed 5,000 characters. Any supplied expand field names must contain no more than 5,000 characters; request the CVC explicitly with expand when it is available for a virtual card.