Skip to main content
PATCH
Update jurisdiction rate

Authorizations

x-api-key
string
header
default:<your-api-key>
required
organisation
string
header
default:<your-organisation-id>
required

Path Parameters

business_entity_id
string<uuid>
required
jurisdiction_rate_id
string<uuid>
required

Body

application/json

PATCH update — all fields optional. Only fields explicitly sent are written; everything else stays as-is on the row.

Cross-field invariants that depend on a complete picture (zip half-set, destination hierarchy) run in the service against the merged row — not against the patch alone, since a partial patch legitimately omits fields the row already has set. The schema only catches errors visible inside the patch itself (zip range ordering

  • length, effective-date ordering, both when both ends are sent).
country_code
string | null

ISO country code (e.g. IN, US)

Required string length: 2
state_code
string | null
city
string | null
zip_code_start
string | null
zip_code_end
string | null
tax_category_id
string<uuid> | null
effective_from
string<date> | null
effective_to
string<date> | null
is_active
boolean | null
name
string | null

Response

Successful Response

Response shape for a jurisdiction rate row.

id
string<uuid>
required
business_entity_id
string<uuid>
required
organization_id
string<uuid>
required
country_code
string
required
state_code
string | null
required
city
string | null
required
zip_code_start
string | null
required
zip_code_end
string | null
required
tax_category_id
string<uuid>
required
effective_from
string<date>
required
effective_to
string<date> | null
required
is_active
boolean
required
name
string | null
required
rates
TaxRateResponseSchema · object[] | null

Inline tax rates (included on create)