Sample - Stripe API
POST/v1/tax/registrations/{id}

Update a tax registration

Updates an existing Tax Registration object. Use active_from to set when the registration becomes active and expires_at to end it; registrations cannot be deleted after creation.

  • RetriesRetries up to 2×, 500ms backoff, 30s timeout.
  • IdempotentThe SDK sends Idempotency-Key, so a retried request is only applied once.

1 parameter · 3 body fields
idstringrequired
The unique identifier of the Tax Registration to update. Maximum 5000 characters.

Optional form-encoded fields for changing the activation or expiration time of a Tax Registration.

active_fromstringoptional
Time at which the registration becomes active. It can be either `now` to indicate the current time, or a timestamp measured in seconds since the Unix epoch.
Allowed:now
expandarray<string>optional
Specifies which fields in the response should be expanded.
expires_atstringoptional
If set, the registration stops being active at this time. If not set, the registration will be active indefinitely. It can be either `now` to indicate the current time, or a timestamp measured in seconds since the Unix epoch.
Allowed:now

2 status codes
200Returns the updated Tax Registration object with its activation time, expiration time, status, and country-specific configuration.
active_fromintegerrequired
Time at which the registration becomes active. Measured in seconds since the Unix epoch.
countrystringrequired
Two-letter country code ([ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)).
country_optionsobjectrequired
createdintegerrequired
Time at which the object was created. Measured in seconds since the Unix epoch.
expires_atintegeroptional
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.
idstringrequired
Unique identifier for the object.
livemodebooleanrequired
If the object exists in live mode, the value is `true`. If the object exists in test mode, the value is `false`.
objectstringrequired
String representing the object's type. Objects of the same type share the same value.
Allowed:tax.registration
statusstringrequired
The status of the registration. This field is present for convenience and can be deduced from `active_from` and `expires_at`.
Allowed:activeexpiredscheduled
defaultReturned when the API reports an error. The response contains an `error` object with an error type and may include a message, code, parameter, or related resource.
errorobjectrequired

Error handling

id must be a string no longer than 5000 characters and must identify an existing Tax Registration. active_from accepts now or a Unix timestamp, while expires_at accepts now, a Unix timestamp, or an empty string.