v1

latestOpenAPI 3.1.02026-07-26549156879.0 KB

Finance > TaxRate

Creates a Tax rate

post/api/2026-07-01/resources/finance/tax_rates

Request body

descriptionstring

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

ratenumber

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

tax_type_idstring

The identifier of the related TaxType record.

external_idstring

The external id of the tax rate.

Example request

{
  "description": "VAT for general goods",
  "rate": 0.07,
  "tax_type_id": "1234",
  "external_id": "EXT-RATE-001"
}

Response

CREATED

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"
}