Sample - Stripe API
GET/v1/tax_ids

List all tax IDs

Lists tax IDs belonging to an account or customer. Use owner to scope the collection, starting_after or ending_before to paginate, and limit to control the page size. Use expand when you need expanded response fields.

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

5 parameters
ending_beforestringoptional
Cursor identifying the item before which to retrieve the previous page. Maximum 5,000 characters.
expandarray<string>optional
Fields to expand in the response. Each expansion value can contain up to 5,000 characters.
limitintegeroptional
Maximum number of tax IDs to return. Must be between 1 and 100 and defaults to 10 when omitted.
ownerobjectoptional
The account or customer that owns the tax ID. Its `type` must be account, application, customer, or self; it defaults to `self` when omitted.
starting_afterstringoptional
Cursor identifying the item after which to retrieve the next page. Maximum 5,000 characters.

2 status codes
200Returns a paginated list object containing tax IDs, a `has_more` indicator, the list object type, and the collection 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

owner[type] is required when owner is provided and must be one of: account, application, customer, or self; the owner defaults to self when omitted. limit must be between 1 and 100 and defaults to 10 when omitted, and each cursor must be a string of no more than 5,000 characters.