v52

latestOpenAPI 3.0.0raw.githubusercontent.com2026-08-015891,4406.1 MB

Update a registration

Updates an existing Tax Registration object.

A registration cannot be deleted after it has been created. If you wish to end a registration you may do so by setting expires_at.

post/v1/tax/registrations/{id}

Path parameters

idstring required

Response

Successful response.

active_frominteger required

Time at which the registration becomes active. Measured in seconds since the Unix epoch.

countrystring required

Two-letter country code (ISO 3166-1 alpha-2).

createdinteger required

Time at which the object was created. Measured in seconds since the Unix epoch.

expires_atinteger nullable

If set, the registration stops being active at this time. If not set, the registration will be active indefinitely. Measured in seconds since the Unix epoch.

idstring required

Unique identifier for the object.

livemodeboolean required

If the object exists in live mode, the value is true. If the object exists in test mode, the value is false.

object'tax.registration' required

String representing the object's type. Objects of the same type share the same value.

status'active' | 'expired' | 'scheduled' required

The status of the registration. This field is present for convenience and can be deduced from active_from and expires_at.