Sample - Stripe API
GET/v1/issuing/cardholders/{cardholder}

Retrieve an Issuing cardholder

Retrieves an Issuing cardholder by its identifier. Use expand when you need selected nested fields included in the response rather than returned as identifiers. The response contains the cardholder's identity, billing information, status, requirements, and spending controls.

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

2 parameters
cardholderstringrequired
The unique identifier of the Issuing cardholder. Maximum 5,000 characters.
expandarray<string>optional
Fields to expand in the cardholder response. Each field name can contain up to 5,000 characters.

2 status codes
200Returns the Issuing cardholder object, including its identifier, name, billing details, status, requirements, metadata, and spending controls.
billingobjectrequired
companyobjectoptional
Additional information about a `company` cardholder.
createdintegerrequired
Time at which the object was created. Measured in seconds since the Unix epoch.
emailstringoptional
The cardholder's email address.
idstringrequired
Unique identifier for the object.
individualobjectoptional
Additional information about an `individual` cardholder.
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.
namestringrequired
The cardholder's name. This will be printed on cards issued to them.
objectstringrequired
String representing the object's type. Objects of the same type share the same value.
Allowed:issuing.cardholder
phone_numberstringoptional
The cardholder's phone number. This is required for all cardholders who will be creating EU cards. See the [3D Secure documentation](https://docs.stripe.com/issuing/3d-secure#when-is-3d-secure-applied) for more details.
preferred_localesarray<string>optional
The cardholder’s preferred locales (languages), ordered by preference. Locales can be `de`, `en`, `es`, `fr`, or `it`. This changes the language of the [3D Secure flow](https://docs.stripe.com/issuing/3d-secure) and one-time password messages sent to the cardholder.
requirementsobjectrequired
spending_controlsobjectoptional
Rules that control spending across this cardholder's cards. Refer to our [documentation](https://docs.stripe.com/issuing/controls/spending-controls) for more details.
statusstringrequired
Specifies whether to permit authorizations on this cardholder's cards.
Allowed:activeblockedinactive
typestringrequired
One of `individual` or `company`. See [Choose a cardholder type](https://docs.stripe.com/issuing/other/choose-cardholder) for more details.
Allowed:companyindividual
defaultError response.
errorobjectrequired

Error handling

cardholder must identify the cardholder to retrieve and must not exceed 5,000 characters. Any supplied expand field names must contain no more than 5,000 characters.