Skip to main content
taxes

List /taxes

List tenant tax rates (optional query matches name). Each item includes uuid, name and rate. The uuid can be used as tax: {id: <uuid>} when writing an item, expense or invoice line; the numeric legacy id is still accepted. Response: items and pagination.

GET
/taxes

Authorizations

Authorizationstringheaderrequired

API key (Bearer token) created in Setup → API & MCP.

Query Parameters

querystringquery

Optional search phrase (matches name).

Minimum string length: 1
pageintegerquery

Page number (1-based).

Required range: 1 <= x
per_pageintegerquery

Number of results per page. limit is accepted as an alias.

Required range: 1 <= x <= 500
sortstringquery

Optional sort order, comma-separated; prefix a field with - for descending (e.g. sort=-updated_at); empty values sort last. Sortable fields: rate, uuid. Default when omitted: taxrate.

fieldsstring[]query

Optional response field paths (dot notation for nested groups, e.g. billing_address.street; array fields are returned whole). Comma-separated string is also accepted. Identifier field is always included.

Response

application/json

Search results

itemsobject[]
paginationobject
querystring

Still need help? Ask the team