Create a registration

Changed on

Creates a new Tax Registration object.

post/v1/tax/registrations

Request

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

Request body application/x-www-form-urlencoded

countrystring required

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

expandstring[]

Specifies which fields in the response should be expanded.

expires_atinteger

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.

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.