List tax rates

GET/v1/tax-rates

Returns the tax rates of a business.

Tax rates are saved per business and picked on document lines. Each line freezes the rate's name, percent and calculation, so changing or archiving a rate never changes documents already created. Archived rates are left out unless you pass archived=true. See Taxes.

Permission: businesses.view
Type: Read-only. Changes nothing.
Auth: API key, MCP token or signed-in session
Capability: list_tax_rates
CLI: freeinvoiceautomation tax-rate list
Available: At launch, 1 January 2027

list_tax_rates

curl --request GET \
  --url https://api.freeinvoiceautomation.com/v1/tax-rates \
  --header 'Authorization: Bearer <api-key>'

{
  "data": [
    {
      "id": "0193f2a0-1c2d-7e3f-8a4b-5c6d7e8f9a0b",
      "business_id": "0193f29e-11aa-7c3b-8d2e-5a6b7c8d9e0f",
      "name": "VAT 20%",
      "rate": "20.0000",
      "calculation": "exclusive",
      "compound": false,
      "preset_key": null,
      "archived_at": null,
      "created_at": "2027-01-02T08:31:10Z",
      "updated_at": "2027-01-02T08:31:10Z"
    }
  ],
  "next_cursor": null,
  "has_more": false
}

Authorizations

Authorizationstringrequired

Bearer <api-key>. An API key from Settings > API keys, or an MCP token. See Authentication.

Query Parameters

business_idstring<uuid>

Only rates of this business. May be left out when you can reach exactly one business.

archivedbooleandefault:false

Set to true to list archived rates instead.

limitintegerdefault:50

Page size, 1 to 200.

cursorstring

Cursor from the previous page's next_cursor.

Response

200 - application/json

dataobject[]

The tax rates on this page.

next_cursorstring | null

Cursor for the next page, or null on the last page.

has_moreboolean

Whether another page exists.

Errors

business_out_of_scope

Plus the common errors every call can return. See Errors.

Suggest edits Raise issue

Delete a businessPrevious Create or update a tax rateNext

list_tax_rates

curl --request GET \
  --url https://api.freeinvoiceautomation.com/v1/tax-rates \
  --header 'Authorization: Bearer <api-key>'

{
  "data": [
    {
      "id": "0193f2a0-1c2d-7e3f-8a4b-5c6d7e8f9a0b",
      "business_id": "0193f29e-11aa-7c3b-8d2e-5a6b7c8d9e0f",
      "name": "VAT 20%",
      "rate": "20.0000",
      "calculation": "exclusive",
      "compound": false,
      "preset_key": null,
      "archived_at": null,
      "created_at": "2027-01-02T08:31:10Z",
      "updated_at": "2027-01-02T08:31:10Z"
    }
  ],
  "next_cursor": null,
  "has_more": false
}