POST
/
tax-rates
curl --request POST \
  --url https://eu.sequencehq.com/api/tax-rates \
  --header 'Content-Type: application/json' \
  --data '{
  "amount": "0.2",
  "country": "GB",
  "description": "Value Added Tax applied to sales in the UK",
  "invoiceName": "Value Added Tax",
  "invoiceShortName": "VAT",
  "isPublished": false,
  "name": "UK Sales Tax",
  "region": "London",
  "subRates": [],
  "taxCategoryId": "ce109c64-dcc0-487a-ac8c-e3237c60cdb6"
}'
{
  "amount": "0.2",
  "country": "GB",
  "description": "Value Added Tax applied to sales in the UK",
  "id": "d58bf2e3-7a5d-4900-8457-2521c6880f7d",
  "invoiceName": "Value Added Tax",
  "invoiceShortName": "VAT",
  "isArchived": false,
  "isPublished": false,
  "name": "UK Sales Tax",
  "region": "London",
  "sequenceAccountId": "dce9ae85-d8d0-42b4-bcad-f221a64363c6",
  "subRates": [],
  "taxCategoryId": "ce109c64-dcc0-487a-ac8c-e3237c60cdb6",
  "version": 0,
  "versionId": "82ef6f1a-afc2-4a8d-b868-6d9c72bf395f"
}

Body

application/json
amount
string
required

The tax rate. Must be between 0 and 100. If this tax rate has any sub-rates, then all sub-rates must add up to this amount.

country
enum<string>
required
Available options:
AD,
AE,
AF,
AG,
AI,
AL,
AM,
AO,
AQ,
AR,
AS,
AT,
AU,
AW,
AX,
AZ,
BA,
BB,
BD,
BE,
BF,
BG,
BH,
BI,
BJ,
BL,
BM,
BN,
BO,
BQ,
BR,
BS,
BT,
BV,
BW,
BY,
BZ,
CA,
CC,
CD,
CF,
CG,
CH,
CI,
CK,
CL,
CM,
CN,
CO,
CR,
CU,
CV,
CW,
CX,
CY,
CZ,
DE,
DJ,
DK,
DM,
DO,
DZ,
EC,
EE,
EG,
EH,
ER,
ES,
ET,
FI,
FJ,
FK,
FM,
FO,
FR,
GA,
GB,
GD,
GE,
GF,
GG,
GH,
GI,
GL,
GM,
GN,
GP,
GQ,
GR,
GS,
GT,
GU,
GW,
GY,
HK,
HM,
HN,
HR,
HT,
HU,
ID,
IE,
IL,
IM,
IN,
IO,
IQ,
IR,
IS,
IT,
JE,
JM,
JO,
JP,
KE,
KG,
KH,
KI,
KM,
KN,
KP,
KR,
KW,
KY,
KZ,
LA,
LB,
LC,
LI,
LK,
LR,
LS,
LT,
LU,
LV,
LY,
MA,
MC,
MD,
ME,
MF,
MG,
MH,
MK,
ML,
MM,
MN,
MO,
MP,
MQ,
MR,
MS,
MT,
MU,
MV,
MW,
MX,
MY,
MZ,
NA,
NC,
NE,
NF,
NG,
NI,
NL,
NO,
NP,
NR,
NU,
NZ,
OM,
PA,
PE,
PF,
PG,
PH,
PK,
PL,
PM,
PN,
PR,
PS,
PT,
PW,
PY,
QA,
RE,
RO,
RS,
RU,
RW,
SA,
SB,
SC,
SD,
SE,
SG,
SH,
SI,
SJ,
SK,
SL,
SM,
SN,
SO,
SR,
SS,
ST,
SV,
SX,
SY,
SZ,
TC,
TD,
TF,
TG,
TH,
TJ,
TK,
TL,
TM,
TN,
TO,
TR,
TT,
TV,
TW,
TZ,
UA,
UG,
UM,
US,
UY,
UZ,
VA,
VC,
VE,
VG,
VI,
VN,
VU,
WF,
WS,
XK,
YE,
YT,
ZA,
ZM,
ZW
description
string

The description of the tax rate

invoiceName
string
required

The long name used on the invoice, e.g. "Value Added Tax"

invoiceShortName
string
required

The short name used on the invoice, e.g. "VAT"

isPublished
boolean
required

Tax Rate status

name
string
required

The full name of the tax rate, e.g. "Sales tax"

region
string

The region that this tax rate applies to

subRates
any[]

The sub rates of this tax rate

taxCategoryId
string

The Tax Category Version ID that this Tax Rate is part of

Response

201 - application/json
amount
string
required

The tax rate. Must be between 0 and 100. If this tax rate has any sub-rates, then all sub-rates must add up to this amount.

country
enum<string>
required
Available options:
AD,
AE,
AF,
AG,
AI,
AL,
AM,
AO,
AQ,
AR,
AS,
AT,
AU,
AW,
AX,
AZ,
BA,
BB,
BD,
BE,
BF,
BG,
BH,
BI,
BJ,
BL,
BM,
BN,
BO,
BQ,
BR,
BS,
BT,
BV,
BW,
BY,
BZ,
CA,
CC,
CD,
CF,
CG,
CH,
CI,
CK,
CL,
CM,
CN,
CO,
CR,
CU,
CV,
CW,
CX,
CY,
CZ,
DE,
DJ,
DK,
DM,
DO,
DZ,
EC,
EE,
EG,
EH,
ER,
ES,
ET,
FI,
FJ,
FK,
FM,
FO,
FR,
GA,
GB,
GD,
GE,
GF,
GG,
GH,
GI,
GL,
GM,
GN,
GP,
GQ,
GR,
GS,
GT,
GU,
GW,
GY,
HK,
HM,
HN,
HR,
HT,
HU,
ID,
IE,
IL,
IM,
IN,
IO,
IQ,
IR,
IS,
IT,
JE,
JM,
JO,
JP,
KE,
KG,
KH,
KI,
KM,
KN,
KP,
KR,
KW,
KY,
KZ,
LA,
LB,
LC,
LI,
LK,
LR,
LS,
LT,
LU,
LV,
LY,
MA,
MC,
MD,
ME,
MF,
MG,
MH,
MK,
ML,
MM,
MN,
MO,
MP,
MQ,
MR,
MS,
MT,
MU,
MV,
MW,
MX,
MY,
MZ,
NA,
NC,
NE,
NF,
NG,
NI,
NL,
NO,
NP,
NR,
NU,
NZ,
OM,
PA,
PE,
PF,
PG,
PH,
PK,
PL,
PM,
PN,
PR,
PS,
PT,
PW,
PY,
QA,
RE,
RO,
RS,
RU,
RW,
SA,
SB,
SC,
SD,
SE,
SG,
SH,
SI,
SJ,
SK,
SL,
SM,
SN,
SO,
SR,
SS,
ST,
SV,
SX,
SY,
SZ,
TC,
TD,
TF,
TG,
TH,
TJ,
TK,
TL,
TM,
TN,
TO,
TR,
TT,
TV,
TW,
TZ,
UA,
UG,
UM,
US,
UY,
UZ,
VA,
VC,
VE,
VG,
VI,
VN,
VU,
WF,
WS,
XK,
YE,
YT,
ZA,
ZM,
ZW
description
string

The description of the tax rate

id
string
required

Tax Rate ID

invoiceName
string
required

The long name used on the invoice, e.g. "Value Added Tax"

invoiceShortName
string
required

The short name used on the invoice, e.g. "VAT"

isArchived
boolean
required

Archived

isPublished
boolean
required

Tax Rate status

name
string
required

The full name of the tax rate, e.g. "Sales tax"

region
string

The region that this tax rate applies to

sequenceAccountId
string
required

Sequence Account ID

subRates
any[]

The sub rates of this tax rate

taxCategoryId
string

The Tax Category ID that this Tax Rate is part of

version
integer
required

Tax Rate version

versionId
string
required

Tax Rate Version ID