Sample - Stripe API
GET/v1/customers/{customer}/tax_ids

List customer tax IDs

Lists all tax IDs associated with a customer. Use cursor parameters to page through results and limit to control the number of tax IDs returned per request. You can also use expand to request expanded response fields.

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

5 parameters
customerstringrequired
The identifier of the customer whose tax IDs to list. Maximum 5000 characters.
ending_beforestringoptional
A pagination cursor identifying an object before the page you want to retrieve. Maximum 5000 characters.
expandarray<string>optional
Fields to expand in the response. Each entry can be no longer than 5000 characters.
limitintegeroptional
The number of tax IDs to return. Must be between 1 and 100; defaults to 10 when omitted.
starting_afterstringoptional
A pagination cursor identifying an object after the page you want to retrieve. Maximum 5000 characters.

2 status codes
200Returns a tax ID list containing `data`, a `has_more` indicator, the list object type, and the list URL.
dataarray<TaxID>required
Details about each object.
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

customer must identify the customer whose tax IDs to list. limit must be between 1 and 100, and ending_before, starting_after, and each expand entry must be no longer than 5000 characters.