Sample - Stripe API
POST/v1/tax/registrations

Create a registration

Creates a new Tax Registration object.

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

5 body fields
active_fromstringrequired
Time at which the Tax Registration becomes active. It can be either `now` to indicate the current time, or a future timestamp measured in seconds since the Unix epoch.
Allowed:now
countrystringrequired
Two-letter country code ([ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)).
country_optionsobjectrequired
Specific options for a registration in the specified `country`.
expandarray<string>optional
Specifies which fields in the response should be expanded.
expires_atintegeroptional
If set, the Tax Registration stops being active at this time. If not set, the Tax Registration will be active indefinitely. Timestamp measured in seconds since the Unix epoch.

2 status codes
200Successful response.
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
defaultError response.
errorobjectrequired

Error handling

Any other status is an error: Error response.