Use the Registrations API to manage tax registrations

Learn how to add, schedule, and check active tax registrations.

Businesses are required to register to collect taxes in locations where they have tax obligations. The Tax Registration API lets you retrieve and configure tax registrations using an API instead of the Dashboard. Adding your registrations in Stripe turns on tax calculation and collection for your transactions made through Stripe.

Different rules determine when and how a business needs to register to collect tax depending on the location. You can also use Stripe to register on your behalf or do it yourself. Learn more about tax collection in different locations.

Connect platform: As a platform, you can use this API to manage the registrations of your connected accounts or to check an account’s active registrations.
Direct usage: You can use this API to manage and check your registrations.

Add a tax registration

After you register with local tax authorities, add the registration to Stripe Tax by calling create Registration:

In this case, Stripe creates a tax.registration object:

{
  "object": "tax.registration",
  "active_from": 1669249440,
  "country": "IE",
  "country_options": {
    "ie": {
      "type": "oss_union"
    }
  },
  "livemode": false,
  "status": "active",
  ...
}

Head office address requirement

To add a tax registration, you must first set up a head office address. Without a defined head office address, an invalid_request_error gets triggered with a message about setting your head office address.

Use the tax settings API to add a head office address:

Location-specific validation and errors might occur, details of which are found in our tax settings guide.

Update and expire a tax registration

You can’t delete a tax registration in Stripe Tax. If you deregister with local tax authorities and need to stop collecting tax in that location, expire the registration. To expire a tax registration, set its expires_at timestamp by calling update Registration:

In this case, the registration expires immediately. Tax calculations performed after the expires_at won’t use this registration:

{
  "object": "tax.registration",
  "active_from": 1669248000,
  "created": 1669219200,
  "expires_at": 1669334400,
  "livemode": false,
  "status": "active",
  ...
}

List all your tax registrations

You can display all your tax registrations performing a list registrations call. The status parameter allows you to filter for only active, expired, or scheduled tax registrations:

OptionalAdd a tax registration for the retail delivery fee
Server-side

To calculate the retail delivery fee, you need to add a tax registration in Colorado, United States, or in Minnesota, United States, with the registration type state_retail_delivery_fee.

After adding the tax registration, the retail delivery fee applies to tax calculations if the item sold meets the requirements of the different states. The fee applies in Minnesota, for example, on orders above 100 USD.

Refer to the documentation to check if the retail delivery fee applies: