Use the Registrations API to manage 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. 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 for your connected account
If a tax obligation and registration of the connected account is known to the platform, you can perform a create registration call using the Stripe-Account header with a value of the connected account ID to add or schedule the registration for the connected account.
In this case, a tax.registration object is created in the connected account.
{ "object": "tax.registration", "active_from": 1669249440, "country": "IE", "country_options": { "ie": { "type": "oss_union" } }, "livemode": false, "status": "active", ... }
Alternatively, for connected accounts with access to the Stripe Dashboard (for example, Standard accounts), you can instruct them to set up Stripe Tax using the Dashboard, which includes adding tax registrations.
Update and expire a tax registration for your connected account
You can’t delete a registration after it’s created, but you can end it by setting expires_at to a time when the registration is no longer active. Update the registrations with an update registration call using the Stripe-Account header with a value of the connected account ID:
In this case, the registration expires immediately. Tax calculations performed for the connected account 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 tax registrations for your connected account
You can display all tax registrations of your connected accounts performing a list registrations call. The status parameter allows you to filter for only active, expired, or scheduled tax registrations.
Use this endpoint if your connected accounts don’t have access to the Stripe Dashboard (for example, Custom and Express accounts) and you want to allow them to manage their tax registrations on your platform’s Dashboard.