Sample - Stripe API
GET/v1/issuing/cardholders

List Issuing cardholders

Lists Issuing cardholders in descending creation order, with the newest cardholders first. Use the available filters to narrow results by creation interval, email, phone number, status, or type, and use cursor parameters to retrieve additional pages.

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

9 parameters
createdobjectoptional
Filters cardholders by creation time using a Unix timestamp or a date-interval object.
emailstringoptional
Filters results to cardholders with the specified email address.
ending_beforestringoptional
Object ID cursor that identifies the end of the current position when retrieving the previous page.
expandarray<string>optional
Fields to expand in each cardholder response. Each field name can contain up to 5,000 characters.
limitintegeroptional
Maximum number of cardholders to return. Must be between 1 and 100. Defaults to 10 when omitted.
phone_numberstringoptional
Filters results to cardholders with the specified phone number.
starting_afterstringoptional
Object ID cursor that identifies the current position when retrieving the next page.
statusstringoptional
Filters by cardholder status: active, blocked, or inactive.
Allowed:activeblockedinactive
typestringoptional
Filters by cardholder type: company or individual.
Allowed:companyindividual

2 status codes
200Returns a list object containing cardholder objects in descending creation order, a `has_more` flag, the list object type, and the collection URL.
dataarray<Cardholder>required
has_morebooleanrequired
True if this list has another page of items after this one that can be fetched.
objectstringrequired
String representing the object's type. Objects of the same type share the same value. Always has the value `list`.
Allowed:list
urlstringrequired
The URL where this list can be accessed.
defaultError response.
errorobjectrequired

Error handling

limit must be between 1 and 100 and defaults to 10 when omitted. status must be one of active, blocked, or inactive, while type must be company or individual. Use starting_after and ending_before as object-ID cursors when navigating pages.