v1

latestOpenAPI 3.1.02026-07-26549156879.0 KB

Finance > TaxRate

Updates a Tax rate

put/api/2026-07-01/resources/finance/tax_rates/{id}

Path parameters

idstring required

The id of the tax rate.

Request body

idstring required

The id of the tax rate.

descriptionstring

An optional text describing the tax rate's purpose or context.

Example request

{
  "id": "123",
  "description": "VAT for general goods"
}

Response

idstring required

Factorial id

ratenumber required

Specifies the numerical percentage for the tax rate between -1 and 1.

descriptionstring

An optional text describing the tax rate's purpose or context.

tax_type_idstring required

The identifier of the related TaxType record.

external_idstring

The external id of the tax rate.

updated_atstring required

Last update date of the tax rate.

Example response

{
  "id": "123",
  "rate": 0.07,
  "description": "VAT for general goods",
  "tax_type_id": "1234",
  "external_id": "EXT-RATE-001",
  "updated_at": "2025-01-01T00:00:00.000Z"
}