Update a registration

Changed on

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}

Request

  • Base URL: https://api.stripe.com
  • URL: https://api.stripe.com/v1/tax/registrations/{id}
  • Auth: one of:
    • HTTP basic
    • HTTP bearer

Path parameters

idstring required

Request body application/x-www-form-urlencoded

expandstring[]

Specifies which fields in the response should be expanded.

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.

Changes

  • c113b1939b8fRevision changes
    • info

      added the optional property ////// to the response with the status

  • 7b8f614372caRevision changes
    • info

      added the optional property ////////// to the response with the status

Some revisions have not been checked yet.