FAfactorialhr
Finance > TaxRate

Updates a Tax rate

Changed on

Updates a Tax rate

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

Request

  • Base URL
    https://api.factorialhr.com
  • URL
    https://api.factorialhr.com/api/2026-10-01/resources/finance/tax_rates/{id}
  • Auth
    API key in header x-api-key

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

OK

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

Changes