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

Retrieve a tax registration

Retrieves a Tax Registration object by its identifier. Use expand when you need selected response fields expanded instead of returned as references.

  • RetriesRetries up to 2×, 500ms backoff, 30s timeout.

2 parameters
idstringrequired
The unique identifier of the Tax Registration. Maximum 5000 characters.
expandarray<string>optional
Fields to expand in the response. Each expansion name can be up to 5000 characters.

2 status codes
200Returns a Tax Registration object containing its identifier, country, activation and expiration times, status, country-specific options, and live-mode indicator.
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. Each expand value can be up to 5000 characters.