Retrieve a registration

Returns a Tax Registration object.

Parameters

No parameters.

Returns

A Tax Registration object.

GET /v1/tax/registrations/:id

curl https://api.stripe.com/v1/tax/registrations/taxreg_NkyGPRPytKq66j \
  -u "sk_test_BQokikJ...2HlWgH4olfQ2sk_test_BQokikJOvBiI2HlWgH4olfQ2:"

Response

{
  "id": "taxreg_NkyGPRPytKq66j",
  "object": "tax.registration",
  "active_from": 1682036640,
  "country": "US",
  "country_options": {
    "us": {
      "state": "CA",
      "type": "state_sales_tax"
    }
  },
  "created": 1682006400,
  "expires_at": null,
  "livemode": false,
  "status": "active",
  "state": "CA",
  "type": "standard"
}

List registrations

Returns a list of Tax Registration objects.

Parameters

statusenum
The status of the Tax Registration.
Possible enum values
active
Return all active Tax Registrations.
all
Return all Tax Registrations (default).
expired
Return all expired Tax Registrations.
scheduled
Return all scheduled Tax Registrations.

More parameters

ending_beforestring

limitinteger

starting_afterstring

Returns

A list of Tax Registration objects.

GET /v1/tax/registrations

curl -G https://api.stripe.com/v1/tax/registrations \
  -u "sk_test_BQokikJ...2HlWgH4olfQ2sk_test_BQokikJOvBiI2HlWgH4olfQ2:" \
  -d limit=3

Response

{
  "object": "list",
  "url": "/v1/tax/registrations",
  "has_more": false,
  "data": [
    {
      "id": "taxreg_NkyGPRPytKq66j",
      "object": "tax.registration",
      "active_from": 1682036640,
      "country": "US",
      "country_options": {
        "us": {
          "state": "CA",
          "type": "state_sales_tax"
        }
      },
      "created": 1682006400,
      "expires_at": null,
      "livemode": false,
      "status": "active",
      "state": "CA",
      "type": "standard"
    }
  ]
}

Retrieve a registration

Parameters

Returns

List registrations

Parameters

statusenum

More parametersExpand all

ending_beforestring

limitinteger

starting_afterstring

Returns

More parameters