GET
/v1/tax_ratesList all tax rates
Lists tax rates, sorted by creation date with the most recently created rates first. Use active, inclusive, and created to filter the collection, and use starting_after or ending_before to paginate the results. Set limit to control the page size and use expand when you need expanded response fields.
- RetriesRetries up to 2×, 500ms backoff, 30s timeout.
activebooleanoptional
Filter tax rates by active or inactive status.
createdobjectoptional
Filter by creation time using an integer timestamp or a range with `gt`, `gte`, `lt`, or `lte` integer bounds.
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.
inclusivebooleanoptional
Filter tax rates by whether they are inclusive or exclusive.
limitintegeroptional
Maximum number of tax rates to return. Must be between 1 and 100 and defaults to 10 when omitted.
starting_afterstringoptional
Cursor identifying the item after which to retrieve the next page. Maximum 5,000 characters.
200Returns a paginated list object containing tax rates, including their active status, display name, percentage, creation time, and other configured properties.
dataarray<TaxRate>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`.
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. created must be an integer timestamp or a range containing integer timestamp bounds, while active and inclusive must be boolean filters.