Create a registration

Tax

Tax Registrations

Creates a new Tax Registration object.

Parameters

active_fromstring | timestampRequired
Time at which the Tax Registration becomes active. It can be either now to indicate the current time, or a future timestamp measured in seconds since the Unix epoch.

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

country_optionsobjectRequired

Specific options for a registration in the specified country.

country_options.aeobjectRequired if country is ae
Options for the registration in AE.
- country_options.ae.typeenumRequired
  Type of registration to be created in country.
  Possible enum values
  standard
  A standard Tax Registration in the specified country.

country_options.atobjectRequired if country is at

Options for the registration in AT.

country_options.at.typeenumRequired

Type of registration to be created in an EU country.

Possible enum values

ioss

Common for businesses shipping goods below EUR 150 from non-EU countries to EU customers.

oss_non_union

Common for businesses established outside of the EU selling services to customers in the EU.

oss_union

Common for businesses established in the EU selling goods and services to customers in the EU.

standard

Common for businesses selling goods and services to customers in this country.

country_options.at.standardobjectRequired if type is standard

Options for the standard registration.

country_options.at.standard.place_of_supply_schemeenumRequired

Place of supply scheme used in an EU standard registration.

Possible enum values

small_seller

Small seller place of supply scheme in which the seller’s tax rate is applied to sales across the EU.

standard

Standard place of supply scheme in which tax is applied to sales in this country only.

country_options.auobjectRequired if country is au
Options for the registration in AU.
- country_options.au.typeenumRequired
  Type of registration to be created in country.
  Possible enum values
  standard
  A standard Tax Registration in the specified country.

country_options.beobjectRequired if country is be

Options for the registration in BE.

country_options.be.typeenumRequired

Type of registration to be created in an EU country.

Possible enum values

ioss

Common for businesses shipping goods below EUR 150 from non-EU countries to EU customers.

oss_non_union

Common for businesses established outside of the EU selling services to customers in the EU.

oss_union

Common for businesses established in the EU selling goods and services to customers in the EU.

standard

Common for businesses selling goods and services to customers in this country.

country_options.be.standardobjectRequired if type is standard

Options for the standard registration.

country_options.be.standard.place_of_supply_schemeenumRequired

Place of supply scheme used in an EU standard registration.

Possible enum values

small_seller

Small seller place of supply scheme in which the seller’s tax rate is applied to sales across the EU.

standard

Standard place of supply scheme in which tax is applied to sales in this country only.

country_options.bgobjectRequired if country is bg

Options for the registration in BG.

country_options.bg.typeenumRequired

Type of registration to be created in an EU country.

Possible enum values

ioss

Common for businesses shipping goods below EUR 150 from non-EU countries to EU customers.

oss_non_union

Common for businesses established outside of the EU selling services to customers in the EU.

oss_union

Common for businesses established in the EU selling goods and services to customers in the EU.

standard

Common for businesses selling goods and services to customers in this country.

country_options.bg.standardobjectRequired if type is standard

Options for the standard registration.

country_options.bg.standard.place_of_supply_schemeenumRequired

Place of supply scheme used in an EU standard registration.

Possible enum values

small_seller

Small seller place of supply scheme in which the seller’s tax rate is applied to sales across the EU.

standard

Standard place of supply scheme in which tax is applied to sales in this country only.

country_options.bhobjectRequired if country is bh
Options for the registration in BH.
- country_options.bh.typeenumRequired
  Type of registration to be created in country.
  Possible enum values
  standard
  A standard Tax Registration in the specified country.

country_options.byobjectRequired if country is by
Options for the registration in BY.
- country_options.by.typeenumRequired
  Type of registration to be created in country.
  Possible enum values
  simplified
  A simplified Tax Registration in the specified country.

country_options.caobjectRequired if country is ca

Options for the registration in CA.

country_options.ca.typeenumRequired

Type of registration to be created in Canada.

Possible enum values

province_standard

A Tax Registration in the specified Canadian province to collect PST/RST/QST.

simplified

A simplified Tax Registration in Canada to collect GST/HST.

standard

A standard Tax Registration in Canada to collect GST/HST.

country_options.ca.province_standardobjectRequired if type is province_standard
Options for the provincial tax registration.
- country_options.ca.province_standard.provincestringRequired
  Two-letter CA province code (ISO 3166-2).

country_options.chobjectRequired if country is ch
Options for the registration in CH.
- country_options.ch.typeenumRequired
  Type of registration to be created in country.
  Possible enum values
  standard
  A standard Tax Registration in the specified country.

country_options.clobjectRequired if country is cl
Options for the registration in CL.
- country_options.cl.typeenumRequired
  Type of registration to be created in country.
  Possible enum values
  simplified
  A simplified Tax Registration in the specified country.

country_options.coobjectRequired if country is co
Options for the registration in CO.
- country_options.co.typeenumRequired
  Type of registration to be created in country.
  Possible enum values
  simplified
  A simplified Tax Registration in the specified country.

country_options.crobjectRequired if country is cr
Options for the registration in CR.
- country_options.cr.typeenumRequired
  Type of registration to be created in country.
  Possible enum values
  simplified
  A simplified Tax Registration in the specified country.

country_options.cyobjectRequired if country is cy

Options for the registration in CY.

country_options.cy.typeenumRequired

Type of registration to be created in an EU country.

Possible enum values

ioss

Common for businesses shipping goods below EUR 150 from non-EU countries to EU customers.

oss_non_union

Common for businesses established outside of the EU selling services to customers in the EU.

oss_union

Common for businesses established in the EU selling goods and services to customers in the EU.

standard

Common for businesses selling goods and services to customers in this country.

country_options.cy.standardobjectRequired if type is standard

Options for the standard registration.

country_options.cy.standard.place_of_supply_schemeenumRequired

Place of supply scheme used in an EU standard registration.

Possible enum values

small_seller

Small seller place of supply scheme in which the seller’s tax rate is applied to sales across the EU.

standard

Standard place of supply scheme in which tax is applied to sales in this country only.

country_options.czobjectRequired if country is cz

Options for the registration in CZ.

country_options.cz.typeenumRequired

Type of registration to be created in an EU country.

Possible enum values

ioss

Common for businesses shipping goods below EUR 150 from non-EU countries to EU customers.

oss_non_union

Common for businesses established outside of the EU selling services to customers in the EU.

oss_union

Common for businesses established in the EU selling goods and services to customers in the EU.

standard

Common for businesses selling goods and services to customers in this country.

country_options.cz.standardobjectRequired if type is standard

Options for the standard registration.

country_options.cz.standard.place_of_supply_schemeenumRequired

Place of supply scheme used in an EU standard registration.

Possible enum values

small_seller

Small seller place of supply scheme in which the seller’s tax rate is applied to sales across the EU.

standard

Standard place of supply scheme in which tax is applied to sales in this country only.

country_options.deobjectRequired if country is de

Options for the registration in DE.

country_options.de.typeenumRequired

Type of registration to be created in an EU country.

Possible enum values

ioss

Common for businesses shipping goods below EUR 150 from non-EU countries to EU customers.

oss_non_union

Common for businesses established outside of the EU selling services to customers in the EU.

oss_union

Common for businesses established in the EU selling goods and services to customers in the EU.

standard

Common for businesses selling goods and services to customers in this country.

country_options.de.standardobjectRequired if type is standard

Options for the standard registration.

country_options.de.standard.place_of_supply_schemeenumRequired

Place of supply scheme used in an EU standard registration.

Possible enum values

small_seller

Small seller place of supply scheme in which the seller’s tax rate is applied to sales across the EU.

standard

Standard place of supply scheme in which tax is applied to sales in this country only.

country_options.dkobjectRequired if country is dk

Options for the registration in DK.

country_options.dk.typeenumRequired

Type of registration to be created in an EU country.

Possible enum values

ioss

Common for businesses shipping goods below EUR 150 from non-EU countries to EU customers.

oss_non_union

Common for businesses established outside of the EU selling services to customers in the EU.

oss_union

Common for businesses established in the EU selling goods and services to customers in the EU.

standard

Common for businesses selling goods and services to customers in this country.

country_options.dk.standardobjectRequired if type is standard

Options for the standard registration.

country_options.dk.standard.place_of_supply_schemeenumRequired

Place of supply scheme used in an EU standard registration.

Possible enum values

small_seller

Small seller place of supply scheme in which the seller’s tax rate is applied to sales across the EU.

standard

Standard place of supply scheme in which tax is applied to sales in this country only.

country_options.ecobjectRequired if country is ec
Options for the registration in EC.
- country_options.ec.typeenumRequired
  Type of registration to be created in country.
  Possible enum values
  simplified
  A simplified Tax Registration in the specified country.

country_options.eeobjectRequired if country is ee

Options for the registration in EE.

country_options.ee.typeenumRequired

Type of registration to be created in an EU country.

Possible enum values

ioss

Common for businesses shipping goods below EUR 150 from non-EU countries to EU customers.

oss_non_union

Common for businesses established outside of the EU selling services to customers in the EU.

oss_union

Common for businesses established in the EU selling goods and services to customers in the EU.

standard

Common for businesses selling goods and services to customers in this country.

country_options.ee.standardobjectRequired if type is standard

Options for the standard registration.

country_options.ee.standard.place_of_supply_schemeenumRequired

Place of supply scheme used in an EU standard registration.

Possible enum values

small_seller

Small seller place of supply scheme in which the seller’s tax rate is applied to sales across the EU.

standard

Standard place of supply scheme in which tax is applied to sales in this country only.

country_options.egobjectRequired if country is eg
Options for the registration in EG.
- country_options.eg.typeenumRequired
  Type of registration to be created in country.
  Possible enum values
  simplified
  A simplified Tax Registration in the specified country.

country_options.esobjectRequired if country is es

Options for the registration in ES.

country_options.es.typeenumRequired

Type of registration to be created in an EU country.

Possible enum values

ioss

Common for businesses shipping goods below EUR 150 from non-EU countries to EU customers.

oss_non_union

Common for businesses established outside of the EU selling services to customers in the EU.

oss_union

Common for businesses established in the EU selling goods and services to customers in the EU.

standard

Common for businesses selling goods and services to customers in this country.

country_options.es.standardobjectRequired if type is standard

Options for the standard registration.

country_options.es.standard.place_of_supply_schemeenumRequired

Place of supply scheme used in an EU standard registration.

Possible enum values

small_seller

Small seller place of supply scheme in which the seller’s tax rate is applied to sales across the EU.

standard

Standard place of supply scheme in which tax is applied to sales in this country only.

country_options.fiobjectRequired if country is fi

Options for the registration in FI.

country_options.fi.typeenumRequired

Type of registration to be created in an EU country.

Possible enum values

ioss

Common for businesses shipping goods below EUR 150 from non-EU countries to EU customers.

oss_non_union

Common for businesses established outside of the EU selling services to customers in the EU.

oss_union

Common for businesses established in the EU selling goods and services to customers in the EU.

standard

Common for businesses selling goods and services to customers in this country.

country_options.fi.standardobjectRequired if type is standard

Options for the standard registration.

country_options.fi.standard.place_of_supply_schemeenumRequired

Place of supply scheme used in an EU standard registration.

Possible enum values

small_seller

Small seller place of supply scheme in which the seller’s tax rate is applied to sales across the EU.

standard

Standard place of supply scheme in which tax is applied to sales in this country only.

country_options.frobjectRequired if country is fr

Options for the registration in FR.

country_options.fr.typeenumRequired

Type of registration to be created in an EU country.

Possible enum values

ioss

Common for businesses shipping goods below EUR 150 from non-EU countries to EU customers.

oss_non_union

Common for businesses established outside of the EU selling services to customers in the EU.

oss_union

Common for businesses established in the EU selling goods and services to customers in the EU.

standard

Common for businesses selling goods and services to customers in this country.

country_options.fr.standardobjectRequired if type is standard

Options for the standard registration.

country_options.fr.standard.place_of_supply_schemeenumRequired

Place of supply scheme used in an EU standard registration.

Possible enum values

small_seller

Small seller place of supply scheme in which the seller’s tax rate is applied to sales across the EU.

standard

Standard place of supply scheme in which tax is applied to sales in this country only.

country_options.gbobjectRequired if country is gb
Options for the registration in GB.
- country_options.gb.typeenumRequired
  Type of registration to be created in country.
  Possible enum values
  standard
  A standard Tax Registration in the specified country.

country_options.geobjectRequired if country is ge
Options for the registration in GE.
- country_options.ge.typeenumRequired
  Type of registration to be created in country.
  Possible enum values
  simplified
  A simplified Tax Registration in the specified country.

country_options.grobjectRequired if country is gr

Options for the registration in GR.

country_options.gr.typeenumRequired

Type of registration to be created in an EU country.

Possible enum values

ioss

Common for businesses shipping goods below EUR 150 from non-EU countries to EU customers.

oss_non_union

Common for businesses established outside of the EU selling services to customers in the EU.

oss_union

Common for businesses established in the EU selling goods and services to customers in the EU.

standard

Common for businesses selling goods and services to customers in this country.

country_options.gr.standardobjectRequired if type is standard

Options for the standard registration.

country_options.gr.standard.place_of_supply_schemeenumRequired

Place of supply scheme used in an EU standard registration.

Possible enum values

small_seller

Small seller place of supply scheme in which the seller’s tax rate is applied to sales across the EU.

standard

Standard place of supply scheme in which tax is applied to sales in this country only.

country_options.hrobjectRequired if country is hr

Options for the registration in HR.

country_options.hr.typeenumRequired

Type of registration to be created in an EU country.

Possible enum values

ioss

Common for businesses shipping goods below EUR 150 from non-EU countries to EU customers.

oss_non_union

Common for businesses established outside of the EU selling services to customers in the EU.

oss_union

Common for businesses established in the EU selling goods and services to customers in the EU.

standard

Common for businesses selling goods and services to customers in this country.

country_options.hr.standardobjectRequired if type is standard

Options for the standard registration.

country_options.hr.standard.place_of_supply_schemeenumRequired

Place of supply scheme used in an EU standard registration.

Possible enum values

small_seller

Small seller place of supply scheme in which the seller’s tax rate is applied to sales across the EU.

standard

Standard place of supply scheme in which tax is applied to sales in this country only.

country_options.huobjectRequired if country is hu

Options for the registration in HU.

country_options.hu.typeenumRequired

Type of registration to be created in an EU country.

Possible enum values

ioss

Common for businesses shipping goods below EUR 150 from non-EU countries to EU customers.

oss_non_union

Common for businesses established outside of the EU selling services to customers in the EU.

oss_union

Common for businesses established in the EU selling goods and services to customers in the EU.

standard

Common for businesses selling goods and services to customers in this country.

country_options.hu.standardobjectRequired if type is standard

Options for the standard registration.

country_options.hu.standard.place_of_supply_schemeenumRequired

Place of supply scheme used in an EU standard registration.

Possible enum values

small_seller

Small seller place of supply scheme in which the seller’s tax rate is applied to sales across the EU.

standard

Standard place of supply scheme in which tax is applied to sales in this country only.

country_options.idobjectRequired if country is id
Options for the registration in ID.
- country_options.id.typeenumRequired
  Type of registration to be created in country.
  Possible enum values
  simplified
  A simplified Tax Registration in the specified country.

country_options.ieobjectRequired if country is ie

Options for the registration in IE.

country_options.ie.typeenumRequired

Type of registration to be created in an EU country.

Possible enum values

ioss

Common for businesses shipping goods below EUR 150 from non-EU countries to EU customers.

oss_non_union

Common for businesses established outside of the EU selling services to customers in the EU.

oss_union

Common for businesses established in the EU selling goods and services to customers in the EU.

standard

Common for businesses selling goods and services to customers in this country.

country_options.ie.standardobjectRequired if type is standard

Options for the standard registration.

country_options.ie.standard.place_of_supply_schemeenumRequired

Place of supply scheme used in an EU standard registration.

Possible enum values

small_seller

Small seller place of supply scheme in which the seller’s tax rate is applied to sales across the EU.

standard

Standard place of supply scheme in which tax is applied to sales in this country only.

country_options.isobjectRequired if country is is
Options for the registration in IS.
- country_options.is.typeenumRequired
  Type of registration to be created in country.
  Possible enum values
  standard
  A standard Tax Registration in the specified country.

country_options.itobjectRequired if country is it

Options for the registration in IT.

country_options.it.typeenumRequired

Type of registration to be created in an EU country.

Possible enum values

ioss

Common for businesses shipping goods below EUR 150 from non-EU countries to EU customers.

oss_non_union

Common for businesses established outside of the EU selling services to customers in the EU.

oss_union

Common for businesses established in the EU selling goods and services to customers in the EU.

standard

Common for businesses selling goods and services to customers in this country.

country_options.it.standardobjectRequired if type is standard

Options for the standard registration.

country_options.it.standard.place_of_supply_schemeenumRequired

Place of supply scheme used in an EU standard registration.

Possible enum values

small_seller

Small seller place of supply scheme in which the seller’s tax rate is applied to sales across the EU.

standard

Standard place of supply scheme in which tax is applied to sales in this country only.

country_options.jpobjectRequired if country is jp
Options for the registration in JP.
- country_options.jp.typeenumRequired
  Type of registration to be created in country.
  Possible enum values
  standard
  A standard Tax Registration in the specified country.

country_options.keobjectRequired if country is ke
Options for the registration in KE.
- country_options.ke.typeenumRequired
  Type of registration to be created in country.
  Possible enum values
  simplified
  A simplified Tax Registration in the specified country.

country_options.krobjectRequired if country is kr
Options for the registration in KR.
- country_options.kr.typeenumRequired
  Type of registration to be created in country.
  Possible enum values
  simplified
  A simplified Tax Registration in the specified country.

country_options.kzobjectRequired if country is kz
Options for the registration in KZ.
- country_options.kz.typeenumRequired
  Type of registration to be created in country.
  Possible enum values
  simplified
  A simplified Tax Registration in the specified country.

country_options.ltobjectRequired if country is lt

Options for the registration in LT.

country_options.lt.typeenumRequired

Type of registration to be created in an EU country.

Possible enum values

ioss

Common for businesses shipping goods below EUR 150 from non-EU countries to EU customers.

oss_non_union

Common for businesses established outside of the EU selling services to customers in the EU.

oss_union

Common for businesses established in the EU selling goods and services to customers in the EU.

standard

Common for businesses selling goods and services to customers in this country.

country_options.lt.standardobjectRequired if type is standard

Options for the standard registration.

country_options.lt.standard.place_of_supply_schemeenumRequired

Place of supply scheme used in an EU standard registration.

Possible enum values

small_seller

Small seller place of supply scheme in which the seller’s tax rate is applied to sales across the EU.

standard

Standard place of supply scheme in which tax is applied to sales in this country only.

country_options.luobjectRequired if country is lu

Options for the registration in LU.

country_options.lu.typeenumRequired

Type of registration to be created in an EU country.

Possible enum values

ioss

Common for businesses shipping goods below EUR 150 from non-EU countries to EU customers.

oss_non_union

Common for businesses established outside of the EU selling services to customers in the EU.

oss_union

Common for businesses established in the EU selling goods and services to customers in the EU.

standard

Common for businesses selling goods and services to customers in this country.

country_options.lu.standardobjectRequired if type is standard

Options for the standard registration.

country_options.lu.standard.place_of_supply_schemeenumRequired

Place of supply scheme used in an EU standard registration.

Possible enum values

small_seller

Small seller place of supply scheme in which the seller’s tax rate is applied to sales across the EU.

standard

Standard place of supply scheme in which tax is applied to sales in this country only.

country_options.lvobjectRequired if country is lv

Options for the registration in LV.

country_options.lv.typeenumRequired

Type of registration to be created in an EU country.

Possible enum values

ioss

Common for businesses shipping goods below EUR 150 from non-EU countries to EU customers.

oss_non_union

Common for businesses established outside of the EU selling services to customers in the EU.

oss_union

Common for businesses established in the EU selling goods and services to customers in the EU.

standard

Common for businesses selling goods and services to customers in this country.

country_options.lv.standardobjectRequired if type is standard

Options for the standard registration.

country_options.lv.standard.place_of_supply_schemeenumRequired

Place of supply scheme used in an EU standard registration.

Possible enum values

small_seller

Small seller place of supply scheme in which the seller’s tax rate is applied to sales across the EU.

standard

Standard place of supply scheme in which tax is applied to sales in this country only.

country_options.maobjectRequired if country is ma
Options for the registration in MA.
- country_options.ma.typeenumRequired
  Type of registration to be created in country.
  Possible enum values
  simplified
  A simplified Tax Registration in the specified country.

country_options.mdobjectRequired if country is md
Options for the registration in MD.
- country_options.md.typeenumRequired
  Type of registration to be created in country.
  Possible enum values
  simplified
  A simplified Tax Registration in the specified country.

country_options.mtobjectRequired if country is mt

Options for the registration in MT.

country_options.mt.typeenumRequired

Type of registration to be created in an EU country.

Possible enum values

ioss

Common for businesses shipping goods below EUR 150 from non-EU countries to EU customers.

oss_non_union

Common for businesses established outside of the EU selling services to customers in the EU.

oss_union

Common for businesses established in the EU selling goods and services to customers in the EU.

standard

Common for businesses selling goods and services to customers in this country.

country_options.mt.standardobjectRequired if type is standard

Options for the standard registration.

country_options.mt.standard.place_of_supply_schemeenumRequired

Place of supply scheme used in an EU standard registration.

Possible enum values

small_seller

Small seller place of supply scheme in which the seller’s tax rate is applied to sales across the EU.

standard

Standard place of supply scheme in which tax is applied to sales in this country only.

country_options.mxobjectRequired if country is mx
Options for the registration in MX.
- country_options.mx.typeenumRequired
  Type of registration to be created in country.
  Possible enum values
  simplified
  A simplified Tax Registration in the specified country.

country_options.myobjectRequired if country is my
Options for the registration in MY.
- country_options.my.typeenumRequired
  Type of registration to be created in country.
  Possible enum values
  simplified
  A simplified Tax Registration in the specified country.

country_options.ngobjectRequired if country is ng
Options for the registration in NG.
- country_options.ng.typeenumRequired
  Type of registration to be created in country.
  Possible enum values
  simplified
  A simplified Tax Registration in the specified country.

country_options.nlobjectRequired if country is nl

Options for the registration in NL.

country_options.nl.typeenumRequired

Type of registration to be created in an EU country.

Possible enum values

ioss

Common for businesses shipping goods below EUR 150 from non-EU countries to EU customers.

oss_non_union

Common for businesses established outside of the EU selling services to customers in the EU.

oss_union

Common for businesses established in the EU selling goods and services to customers in the EU.

standard

Common for businesses selling goods and services to customers in this country.

country_options.nl.standardobjectRequired if type is standard

Options for the standard registration.

country_options.nl.standard.place_of_supply_schemeenumRequired

Place of supply scheme used in an EU standard registration.

Possible enum values

small_seller

Small seller place of supply scheme in which the seller’s tax rate is applied to sales across the EU.

standard

Standard place of supply scheme in which tax is applied to sales in this country only.

country_options.noobjectRequired if country is no
Options for the registration in NO.
- country_options.no.typeenumRequired
  Type of registration to be created in country.
  Possible enum values
  standard
  A standard Tax Registration in the specified country.

country_options.nzobjectRequired if country is nz
Options for the registration in NZ.
- country_options.nz.typeenumRequired
  Type of registration to be created in country.
  Possible enum values
  standard
  A standard Tax Registration in the specified country.

country_options.omobjectRequired if country is om
Options for the registration in OM.
- country_options.om.typeenumRequired
  Type of registration to be created in country.
  Possible enum values
  standard
  A standard Tax Registration in the specified country.

country_options.plobjectRequired if country is pl

Options for the registration in PL.

country_options.pl.typeenumRequired

Type of registration to be created in an EU country.

Possible enum values

ioss

Common for businesses shipping goods below EUR 150 from non-EU countries to EU customers.

oss_non_union

Common for businesses established outside of the EU selling services to customers in the EU.

oss_union

Common for businesses established in the EU selling goods and services to customers in the EU.

standard

Common for businesses selling goods and services to customers in this country.

country_options.pl.standardobjectRequired if type is standard

Options for the standard registration.

country_options.pl.standard.place_of_supply_schemeenumRequired

Place of supply scheme used in an EU standard registration.

Possible enum values

small_seller

Small seller place of supply scheme in which the seller’s tax rate is applied to sales across the EU.

standard

Standard place of supply scheme in which tax is applied to sales in this country only.

country_options.ptobjectRequired if country is pt

Options for the registration in PT.

country_options.pt.typeenumRequired

Type of registration to be created in an EU country.

Possible enum values

ioss

Common for businesses shipping goods below EUR 150 from non-EU countries to EU customers.

oss_non_union

Common for businesses established outside of the EU selling services to customers in the EU.

oss_union

Common for businesses established in the EU selling goods and services to customers in the EU.

standard

Common for businesses selling goods and services to customers in this country.

country_options.pt.standardobjectRequired if type is standard

Options for the standard registration.

country_options.pt.standard.place_of_supply_schemeenumRequired

Place of supply scheme used in an EU standard registration.

Possible enum values

small_seller

Small seller place of supply scheme in which the seller’s tax rate is applied to sales across the EU.

standard

Standard place of supply scheme in which tax is applied to sales in this country only.

country_options.roobjectRequired if country is ro

Options for the registration in RO.

country_options.ro.typeenumRequired

Type of registration to be created in an EU country.

Possible enum values

ioss

Common for businesses shipping goods below EUR 150 from non-EU countries to EU customers.

oss_non_union

Common for businesses established outside of the EU selling services to customers in the EU.

oss_union

Common for businesses established in the EU selling goods and services to customers in the EU.

standard

Common for businesses selling goods and services to customers in this country.

country_options.ro.standardobjectRequired if type is standard

Options for the standard registration.

country_options.ro.standard.place_of_supply_schemeenumRequired

Place of supply scheme used in an EU standard registration.

Possible enum values

small_seller

Small seller place of supply scheme in which the seller’s tax rate is applied to sales across the EU.

standard

Standard place of supply scheme in which tax is applied to sales in this country only.

country_options.rsobjectRequired if country is rs
Options for the registration in RS.
- country_options.rs.typeenumRequired
  Type of registration to be created in country.
  Possible enum values
  standard
  A standard Tax Registration in the specified country.

country_options.ruobjectRequired if country is ru
Options for the registration in RU.
- country_options.ru.typeenumRequired
  Type of registration to be created in country.
  Possible enum values
  simplified
  A simplified Tax Registration in the specified country.

country_options.saobjectRequired if country is sa
Options for the registration in SA.
- country_options.sa.typeenumRequired
  Type of registration to be created in country.
  Possible enum values
  simplified
  A simplified Tax Registration in the specified country.

country_options.seobjectRequired if country is se

Options for the registration in SE.

country_options.se.typeenumRequired

Type of registration to be created in an EU country.

Possible enum values

ioss

Common for businesses shipping goods below EUR 150 from non-EU countries to EU customers.

oss_non_union

Common for businesses established outside of the EU selling services to customers in the EU.

oss_union

Common for businesses established in the EU selling goods and services to customers in the EU.

standard

Common for businesses selling goods and services to customers in this country.

country_options.se.standardobjectRequired if type is standard

Options for the standard registration.

country_options.se.standard.place_of_supply_schemeenumRequired

Place of supply scheme used in an EU standard registration.

Possible enum values

small_seller

Small seller place of supply scheme in which the seller’s tax rate is applied to sales across the EU.

standard

Standard place of supply scheme in which tax is applied to sales in this country only.

country_options.sgobjectRequired if country is sg
Options for the registration in SG.
- country_options.sg.typeenumRequired
  Type of registration to be created in country.
  Possible enum values
  standard
  A standard Tax Registration in the specified country.

country_options.siobjectRequired if country is si

Options for the registration in SI.

country_options.si.typeenumRequired

Type of registration to be created in an EU country.

Possible enum values

ioss

Common for businesses shipping goods below EUR 150 from non-EU countries to EU customers.

oss_non_union

Common for businesses established outside of the EU selling services to customers in the EU.

oss_union

Common for businesses established in the EU selling goods and services to customers in the EU.

standard

Common for businesses selling goods and services to customers in this country.

country_options.si.standardobjectRequired if type is standard

Options for the standard registration.

country_options.si.standard.place_of_supply_schemeenumRequired

Place of supply scheme used in an EU standard registration.

Possible enum values

small_seller

Small seller place of supply scheme in which the seller’s tax rate is applied to sales across the EU.

standard

Standard place of supply scheme in which tax is applied to sales in this country only.

country_options.skobjectRequired if country is sk

Options for the registration in SK.

country_options.sk.typeenumRequired

Type of registration to be created in an EU country.

Possible enum values

ioss

Common for businesses shipping goods below EUR 150 from non-EU countries to EU customers.

oss_non_union

Common for businesses established outside of the EU selling services to customers in the EU.

oss_union

Common for businesses established in the EU selling goods and services to customers in the EU.

standard

Common for businesses selling goods and services to customers in this country.

country_options.sk.standardobjectRequired if type is standard

Options for the standard registration.

country_options.sk.standard.place_of_supply_schemeenumRequired

Place of supply scheme used in an EU standard registration.

Possible enum values

small_seller

Small seller place of supply scheme in which the seller’s tax rate is applied to sales across the EU.

standard

Standard place of supply scheme in which tax is applied to sales in this country only.

country_options.thobjectRequired if country is th
Options for the registration in TH.
- country_options.th.typeenumRequired
  Type of registration to be created in country.
  Possible enum values
  simplified
  A simplified Tax Registration in the specified country.

country_options.trobjectRequired if country is tr
Options for the registration in TR.
- country_options.tr.typeenumRequired
  Type of registration to be created in country.
  Possible enum values
  simplified
  A simplified Tax Registration in the specified country.

country_options.tzobjectRequired if country is tz
Options for the registration in TZ.
- country_options.tz.typeenumRequired
  Type of registration to be created in country.
  Possible enum values
  simplified
  A simplified Tax Registration in the specified country.

country_options.usobjectRequired if country is us

Options for the registration in US.

country_options.us.statestringRequired
Two-letter US state code (ISO 3166-2).

country_options.us.typeenumRequired

Type of registration to be created in the US.

Possible enum values

local_amusement_tax

A Tax Registration in the specified US state to collect local amusement tax.

local_lease_tax

A Tax Registration in the specified US state to collect local lease tax.

state_communications_tax

A Tax Registration in the specified US state to collect communications tax.

state_sales_tax

A Tax Registration in the specified US state to collect sales tax.

country_options.us.local_amusement_taxobjectRequired if type is local_amusement_tax
Options for the local amusement tax registration.
- country_options.us.local_amusement_tax.jurisdictionstringRequired
  A FIPS code representing the local jurisdiction. Supported FIPS codes are: 14000 (Chicago), 06613 (Bloomington), 21696 (East Dundee), 24582 (Evanston), and 68081 (Schiller Park).

country_options.us.local_lease_taxobjectRequired if type is local_lease_tax
Options for the local lease tax registration.
- country_options.us.local_lease_tax.jurisdictionstringRequired
  A FIPS code representing the local jurisdiction. Supported FIPS codes are: 14000 (Chicago).

country_options.us.state_sales_taxobject

Options for the state sales tax registration.

country_options.us.state_sales_tax.electionsarray of objectsRequired

Elections for the state sales tax registration.

country_options.us.state_sales_tax.elections.typeenumRequired

The type of the election for the state sales tax registration.

Possible enum values

local_use_tax

Use Tax in Pennsylvania for the city of Philadelphia or Allegheny county which can be collected by remote sellers outside of these locations.

simplified_sellers_use_tax

Simplified Sellers Use Tax which can be collected by remote sellers with no physical presence in Alabama.

single_local_use_tax

Single Local Use Tax Rate which can be collected by remote sellers with no physical presence in Texas.

country_options.us.state_sales_tax.elections.jurisdictionstringRequired if type is local_use_tax
A FIPS code representing the local jurisdiction. Supported FIPS codes are: 003 (Allegheny County) and 60000 (Philadelphia City).

country_options.uzobjectRequired if country is uz
Options for the registration in UZ.
- country_options.uz.typeenumRequired
  Type of registration to be created in country.
  Possible enum values
  simplified
  A simplified Tax Registration in the specified country.

country_options.vnobjectRequired if country is vn
Options for the registration in VN.
- country_options.vn.typeenumRequired
  Type of registration to be created in country.
  Possible enum values
  simplified
  A simplified Tax Registration in the specified country.

country_options.zaobjectRequired if country is za
Options for the registration in ZA.
- country_options.za.typeenumRequired
  Type of registration to be created in country.
  Possible enum values
  standard
  A standard Tax Registration in the specified country.

expires_attimestamp
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.

Returns

A Tax Registration object.

POST /v1/tax/registrations

Server-side language

curl https://api.stripe.com/v1/tax/registrations \
  -u "sk_test_BQokikJ...2HlWgH4olfQ2sk_test_BQokikJOvBiI2HlWgH4olfQ2:" \
  -d country=US \
  -d "country_options[us][state]"=CA \
  -d "country_options[us][type]"=state_sales_tax \
  -d active_from=now

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"
}

Create a registration

Parameters

active_fromstring | timestampRequired

countrystringRequired

country_optionsobjectRequired

country_options.aeobjectRequired if country is ae

country_options.ae.typeenumRequired

country_options.atobjectRequired if country is at

country_options.at.typeenumRequired

country_options.at.standardobjectRequired if type is standard

country_options.at.standard.place_of_supply_schemeenumRequired

country_options.auobjectRequired if country is au

country_options.au.typeenumRequired

country_options.beobjectRequired if country is be

country_options.be.typeenumRequired

country_options.be.standardobjectRequired if type is standard

country_options.be.standard.place_of_supply_schemeenumRequired

country_options.bgobjectRequired if country is bg

country_options.bg.typeenumRequired

country_options.bg.standardobjectRequired if type is standard

country_options.bg.standard.place_of_supply_schemeenumRequired

country_options.bhobjectRequired if country is bh

country_options.bh.typeenumRequired

country_options.byobjectRequired if country is by

country_options.by.typeenumRequired

country_options.caobjectRequired if country is ca

country_options.ca.typeenumRequired

country_options.ca.province_standardobjectRequired if type is province_standard

country_options.ca.province_standard.provincestringRequired

country_options.chobjectRequired if country is ch

country_options.ch.typeenumRequired

country_options.clobjectRequired if country is cl

country_options.cl.typeenumRequired

country_options.coobjectRequired if country is co

country_options.co.typeenumRequired

country_options.crobjectRequired if country is cr

country_options.cr.typeenumRequired

country_options.cyobjectRequired if country is cy

country_options.cy.typeenumRequired

country_options.cy.standardobjectRequired if type is standard

country_options.cy.standard.place_of_supply_schemeenumRequired

country_options.czobjectRequired if country is cz

country_options.cz.typeenumRequired

country_options.cz.standardobjectRequired if type is standard

country_options.cz.standard.place_of_supply_schemeenumRequired

country_options.deobjectRequired if country is de

country_options.de.typeenumRequired

country_options.de.standardobjectRequired if type is standard

country_options.de.standard.place_of_supply_schemeenumRequired

country_options.dkobjectRequired if country is dk

country_options.dk.typeenumRequired

country_options.dk.standardobjectRequired if type is standard

country_options.dk.standard.place_of_supply_schemeenumRequired

country_options.ecobjectRequired if country is ec

country_options.ec.typeenumRequired

country_options.eeobjectRequired if country is ee

country_options.ee.typeenumRequired

country_options.ee.standardobjectRequired if type is standard

country_options.ee.standard.place_of_supply_schemeenumRequired

country_options.egobjectRequired if country is eg

country_options.eg.typeenumRequired

country_options.esobjectRequired if country is es

country_options.es.typeenumRequired

country_options.es.standardobjectRequired if type is standard

country_options.es.standard.place_of_supply_schemeenumRequired

country_options.fiobjectRequired if country is fi

country_options.fi.typeenumRequired

country_options.fi.standardobjectRequired if type is standard

country_options.fi.standard.place_of_supply_schemeenumRequired

country_options.frobjectRequired if country is fr

country_options.fr.typeenumRequired

country_options.fr.standardobjectRequired if type is standard

country_options.fr.standard.place_of_supply_schemeenumRequired

country_options.gbobjectRequired if country is gb

country_options.gb.typeenumRequired

country_options.geobjectRequired if country is ge

country_options.ge.typeenumRequired

country_options.grobjectRequired if country is gr

country_options.gr.typeenumRequired

country_options.gr.standardobjectRequired if type is standard