Tax IDs

Tax IDs identify a business for tax purposes. They appear in two places in the Numeral API:

• Merchant profiles — stored on a merchant to identify the selling entity for documentation and reporting. Set when creating or updating a merchant via POST /tax/merchants.
• Calculation requests — passed on customer.tax_ids when the customer type is BUSINESS. Numeral uses the tax ID to determine whether reverse-charge or zero-rate rules apply — for example, a VAT-registered business purchasing across EU borders may owe zero tax rather than the standard rate.

A tax ID has two fields: type (from the table below) and value (the actual number):

{
  "tax_ids": [
    { "type": "gb_vat", "value": "GB123456789" }
  ]
}

An object can hold more than one tax ID — for example, a business registered in both the US and the EU:

{
  "tax_ids": [
    { "type": "us_ein", "value": "12-3456789" },
    { "type": "eu_vat", "value": "DE123456789" }
  ]
}

For customers, tax_ids is required for BUSINESS type outside the US, and not allowed for CONSUMER type.

---

Supported Tax ID Types

Type	Country	Description
ad_nrt	Andorra	NRT (Número de Registre Tributari)
ae_trn	United Arab Emirates	TRN (Tax Registration Number)
al_tin	Albania	TIN
am_tin	Armenia	TIN
ao_tin	Angola	TIN
ar_cuit	Argentina	CUIT (Clave Única de Identificación Tributaria)
au_abn	Australia	ABN (Australian Business Number)
au_arn	Australia	ARN (ATO Reference Number)
aw_tin	Aruba	TIN
az_tin	Azerbaijan	TIN
ba_tin	Bosnia and Herzegovina	TIN
bb_tin	Barbados	TIN
bd_bin	Bangladesh	BIN (Business Identification Number)
bf_ifu	Burkina Faso	IFU (Identifiant Financier Unique)
bg_uic	Bulgaria	UIC (Unified Identification Code)
bh_vat	Bahrain	VAT number
bj_ifu	Benin	IFU
bo_tin	Bolivia	TIN
br_cnpj	Brazil	CNPJ (Cadastro Nacional da Pessoa Jurídica)
br_cpf	Brazil	CPF (Cadastro de Pessoas Físicas)
bs_tin	Bahamas	TIN
by_tin	Belarus	TIN
ca_bn	Canada	BN (Business Number)
ca_gst_hst	Canada	GST/HST number
ca_pst_bc	Canada	PST — British Columbia
ca_pst_mb	Canada	PST — Manitoba
ca_pst_sk	Canada	PST — Saskatchewan
ca_qst	Canada	QST (Quebec Sales Tax)
cd_nif	Congo	NIF
ch_uid	Switzerland	UID (Unternehmens-Identifikationsnummer)
ch_vat	Switzerland	VAT number
cl_tin	Chile	TIN
cm_niu	Cameroon	NIU (Numéro d’Identification Unique)
cn_tin	China	TIN
co_nit	Colombia	NIT (Número de Identificación Tributaria)
cr_tin	Costa Rica	TIN
cv_nif	Cape Verde	NIF
de_stn	Germany	STN (Steuernummer)
do_rcn	Dominican Republic	RCN
ec_ruc	Ecuador	RUC (Registro Único de Contribuyentes)
eg_tin	Egypt	TIN
es_cif	Spain	CIF (Código de Identificación Fiscal)
et_tin	Ethiopia	TIN
eu_oss_vat	European Union	OSS VAT (One Stop Shop)
eu_vat	European Union	VAT number
gb_vat	United Kingdom	VAT number
ge_vat	Georgia	VAT number
gh_tin	Ghana	TIN
gn_nif	Guinea	NIF
hk_br	Hong Kong	BR (Business Registration Number)
hr_oib	Croatia	OIB (Osobni identifikacijski broj)
hu_tin	Hungary	TIN
id_npwp	Indonesia	NPWP (Nomor Pokok Wajib Pajak)
il_vat	Israel	VAT number
in_gst	India	GST number
is_vat	Iceland	VAT number
jp_cn	Japan	CN (Corporate Number)
jp_rn	Japan	RN (Registered Number)
jp_trn	Japan	TRN
ke_pin	Kenya	PIN (Personal Identification Number)
kg_tin	Kyrgyzstan	TIN
kh_tin	Cambodia	TIN
kr_brn	South Korea	BRN (Business Registration Number)
kz_bin	Kazakhstan	BIN (Business Identification Number)
la_tin	Laos	TIN
li_uid	Liechtenstein	UID
li_vat	Liechtenstein	VAT number
ma_vat	Morocco	VAT number
md_vat	Moldova	VAT number
me_pib	Montenegro	PIB (Poreski identifikacioni broj)
mk_vat	North Macedonia	VAT number
mr_nif	Mauritania	NIF
mx_rfc	Mexico	RFC (Registro Federal de Contribuyentes)
my_frp	Malaysia	FRP
my_itn	Malaysia	ITN (Income Tax Number)
my_sst	Malaysia	SST (Sales and Service Tax)
ng_tin	Nigeria	TIN
no_vat	Norway	VAT number
no_voec	Norway	VOEC (VAT on E-Commerce)
np_pan	Nepal	PAN (Permanent Account Number)
nz_gst	New Zealand	GST number
om_vat	Oman	VAT number
pe_ruc	Peru	RUC (Registro Único de Contribuyentes)
ph_tin	Philippines	TIN
ro_tin	Romania	TIN
rs_pib	Serbia	PIB (Poreski identifikacioni broj)
ru_inn	Russia	INN (Individual Taxpayer Number)
ru_kpp	Russia	KPP (Tax Registration Reason Code)
sa_vat	Saudi Arabia	VAT number
sg_gst	Singapore	GST number
sg_uen	Singapore	UEN (Unique Entity Number)
si_tin	Slovenia	TIN
sn_ninea	Senegal	NINEA
sr_fin	Suriname	FIN
sv_nit	El Salvador	NIT (Número de Identificación Tributaria)
th_vat	Thailand	VAT number
tj_tin	Tajikistan	TIN
tr_tin	Turkey	TIN
tw_vat	Taiwan	VAT number
tz_vat	Tanzania	VAT number
ua_vat	Ukraine	VAT number
ug_tin	Uganda	TIN
us_ein	United States	EIN (Employer Identification Number)
uy_ruc	Uruguay	RUC
uz_tin	Uzbekistan	TIN
uz_vat	Uzbekistan	VAT number
ve_rif	Venezuela	RIF (Registro de Información Fiscal)
vn_tin	Vietnam	TIN
za_vat	South Africa	VAT number
zm_tin	Zambia	TIN
zw_tin	Zimbabwe	TIN