Manage VAT IDs

Overview

A VAT ID (Value Added Tax Identification Number) is a unique government-issued identification number used for tax purposes, specifically for value-added tax. It is assigned to counterparts and helps authorities track and manage tax-related transactions.

VAT ID names and formats vary from country to country. For example, in the European Union, it is referred to as "VAT identification number" or VATIN. Common names in other countries include Business Number (BN), Good and Services Tax number, and sales tax numbers.

Businesses (or counterparts) can have one, multiple, or no VAT IDs depending on the country and regulatory requirements. For example, some countries do not require VAT registration for small businesses with a turnover below a certain threshold. Whereas businesses selling globally are often registered for VAT in multiple jurisdictions and thus have multiple VAT IDs.

Supported VAT ID types

Currently, Monite supports the following VAT ID types:

Country	Type	Description	Example
Australia	`au_abn`	Australian Business Number (AU ABN)	51824753556
Australia	`au_arn`	Australian Taxation Office Reference Number	518247535567
Austria	`eu_vat`	European VAT number	ATU12345678
Belgium	`eu_vat`	European VAT number	BE0123456789
Brazil	`br_cnpj`	Brazilian CNPJ number	28.271.211/0001-88
Brazil	`br_cpf`	Brazilian CPF number	137.609.391-04
Bulgaria	`bg_uic`	Bulgaria Unified Identification Code	123456789
Bulgaria	`eu_vat`	European VAT number	BG0123456789
Canada	`ca_bn`	Canadian BN	123456789
Canada	`ca_gst_hst`	Canadian GST/HST number	123456789RT0002
Canada	`ca_pst_bc`	Canadian PST number (British Columbia)	PST-1234-5678
Canada	`ca_pst_mb`	Canadian PST number (Manitoba)	123456-7
Canada	`ca_pst_sk`	Canadian PST number (Saskatchewan)	1234567
Canada	`ca_qst`	Canadian QST number (Québec)	1234567890TQ1234
Chile	`cl_tin`	Chilean TIN	12.345.678-K
Croatia	`eu_vat`	European VAT number	HR12345678912
Cyprus	`eu_vat`	European VAT number	CY12345678Z
Czech Republic	`eu_vat`	European VAT number	CZ1234567890
Denmark	`eu_vat`	European VAT number	DK12345678
Estonia	`eu_vat`	European VAT number	EE123456789
European Union	`eu_oss_vat`	European One Stop Shop VAT number for non-Union scheme	EU123456789
Finland	`eu_vat`	European VAT number	FI12345678
France	`eu_vat`	European VAT number	FRAB123456789
Georgia	`ge_vat`	Georgian VAT	123456789
Germany	`eu_vat`	European VAT number	DE123456789
Greece	`eu_vat`	European VAT number	EL123456789
Hong Kong	`hk_br`	Hong Kong BR number	12345678
Hungary	`hu_tin`	Hungary tax number (adószám)	12345678-1-23
Hungary	`eu_vat`	European VAT number	HU12345678912
Iceland	`is_vat`	Icelandic VAT	123456
India	`in_gst`	Indian GST number	12ABCDE3456FGZH
Indonesia	`id_npwp`	Indonesian NPWP number	12.345.678.9-012.345
Ireland	`eu_vat`	European VAT number	IE1234567AB
Israel	`il_vat`	Israel VAT	12345
Italy	`eu_vat`	European VAT number	IT12345678912
Japan	`jp_cn`	Japanese Corporate Number (Hōjin Bangō)	1234567891234
Japan	`jp_rn`	Japanese Registered Foreign Businesses' Registration Number (Tōroku Kokugai Jigyōsha no Tōroku Bangō)	12345
Japan	`jp_trn`	Japanese Tax Registration Number (Tōroku Bangō)	T1234567891234
Kenya	`ke_pin`	Kenya Revenue Authority Personal Identification Number	P000111111A
Latvia	`eu_vat`	European VAT number	LV12345678912
Liechtenstein	`li_uid`	Liechtensteinian UID number	CHE123456789
Lithuania	`eu_vat`	European VAT number	LT123456789123
Luxembourg	`eu_vat`	European VAT number	LU12345678
Malaysia	`my_frp`	Malaysian FRP number	12345678
Malaysia	`my_itn`	Malaysian ITN	C 1234567890
Malaysia	`my_sst`	Malaysian SST number	A12-3456-78912345
Malta	`eu_vat`	European VAT number	MT12345678
Mexico	`mx_rfc`	Mexican RFC number	ABC010203AB9
Netherlands	`eu_vat`	European VAT number	NL123456789B12
New Zealand	`nz_gst`	New Zealand GST number	123456789
Norway	`no_vat`	Norwegian VAT number	123456789MVA
Poland	`eu_vat`	European VAT number	PL1234567890
Portugal	`eu_vat`	European VAT number	PT123456789
Romania	`eu_vat`	European VAT number	RO1234567891
Russia	`ru_inn`	Russian INN	1234567891
Russia	`ru_kpp`	Russian KPP	123456789
Saudi Arabia	`sa_vat`	Saudi Arabia VAT	123456789012345
Singapore	`sg_gst`	Singaporean GST	M12345678X
Singapore	`sg_uen`	Singaporean UEN	123456789F
Slovakia	`eu_vat`	European VAT number	SK1234567891
Slovenia	`si_tin`	Slovenia tax number (davčna številka)	12345678
Slovenia	`eu_vat`	European VAT number	SI12345678
South Africa	`za_vat`	South African VAT number	4123456789
South Korea	`kr_brn`	Korean BRN	123-45-67890
Spain	`es_cif`	Spanish NIF number (previously Spanish CIF number)	A12345678
Spain	`eu_vat`	European VAT number	ESA1234567Z
Sweden	`eu_vat`	European VAT number	SE123456789123
Switzerland	`ch_vat`	Switzerland VAT number	CHE-123.456.789 MWST
Taiwan	`tw_vat`	Taiwanese VAT	12345678
Thailand	`th_vat`	Thai VAT	1234567891234
Ukraine	`ua_vat`	Ukrainian VAT	123456789
United Arab Emirates	`ae_trn`	United Arab Emirates TRN	123456789012345
United Kingdom	`gb_vat`	United Kingdom VAT number	GB123456789
United Kingdom	`eu_vat`	Northern Ireland VAT number	XI123456789
United States	`us_ein`	Federal Tax Identification Number or United States EIN	12-3456789

📘
Need another VAT ID type?
You can request additional VAT ID types by sending an email to [email protected].

Add new VAT ID

To associate a new VAT ID to a specific counterpart, call POST /counterparts/{counterpart_id}/vat_ids, passing the VAT ID type and value in the request body:

curl -X POST 'https://api.sandbox.monite.com/v1/counterparts/411dcb...289b3/vat_ids' \
     -H 'X-Monite-Version: 2024-01-31' \
     -H 'X-Monite-Entity-Id: ENTITY_ID' \
     -H 'Authorization: Bearer ACCESS_TOKEN' \
     -H 'Content-Type: application/json' \
     -d '{
       "country": "DE",
       "type": "eu_vat",
       "value": "DE12345678"
     }'

The successful response contains the information about the newly added VAT ID:

{
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "counterpart_id": "411dcb68-dad8-46c2-92b9-f6ae445289b3",
  "country": "DE",
  "type": "eu_vat",
  "value": "DE12345678"
}

List all VAT IDs

To get all VAT IDs of a specific counterpart, make a GET request to the /counterparts/{counterpart_id}/vat_ids endpoint as shown:

curl -X GET 'https://api.sandbox.monite.com/v1/counterparts/411dcb...289b3/vat_ids' \
     -H 'X-Monite-Version: 2024-01-31' \
     -H 'X-Monite-Entity-Id: ENTITY_ID' \
     -H 'Authorization: Bearer ACCESS_TOKEN'

The successful response contains a list of VAT IDs of the specified counterpart:

{
  "data": [
    {
      "country": "DE",
      "type": "eu_vat",
      "value": "DE12345678",
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "counterpart_id": "411dcb68-dad8-46c2-92b9-f6ae445289b3"
    }
  ]
}

Retrieve a VAT ID

To retrieve a specific VAT ID belonging to a counterpart, make a GET request to the /counterparts/{counterpart_id}/vat_ids/{id} endpoint as shown:

curl -X GET 'https://api.sandbox.monite.com/v1/counterparts/411dcb...289b3/vat_ids/3fa85f64...2c963f66afa6' \
     -H 'X-Monite-Version: 2024-01-31' \
     -H 'X-Monite-Entity-Id: ENTITY_ID' \
     -H 'Authorization: Bearer ACCESS_TOKEN'

The successful response returns an object containing details of the counterpart's VAT ID requested.

{
  "country": "AF",
  "type": "eu_vat",
  "value": "123456789",
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "counterpart_id": "411dcb68-dad8-46c2-92b9-f6ae445289b3"
}

Edit a VAT ID

To edit an existing VAT ID of a specific counterpart, make a PATCH request to the /counterparts/{counterpart_id}/vat_ids/{id} endpoint. You can update the VAT ID type, value, or country.

curl -X PATCH 'https://api.sandbox.monite.com/v1/counterparts/411dcb...289b3/vat_ids/3fa85f64...2c963f66afa6' \
     -H 'X-Monite-Version: 2024-01-31' \
     -H 'X-Monite-Entity-Id: ENTITY_ID' \
     -H 'Authorization: Bearer ACCESS_TOKEN' \
     -H 'Content-Type: application/json' \
     -d '{
       "country": "AF",
       "type": "eu_vat",
       "value": "AF125678"
     }'

The successful response returns an object containing details of the updated VAT ID.

{
  "country": "AF",
  "type": "eu_vat",
  "value": "123456789",
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "counterpart_id": "411dcb68-dad8-46c2-92b9-f6ae445289b3"
}

Delete a VAT ID

To delete an existing VAT ID from the list of VAT IDs associated with a specific counterpart, make a DELETE request to the /counterparts/{counterpart_id}/vat_ids/{id} endpoint as shown:

curl -X DELETE 'https://api.sandbox.monite.com/v1/counterparts/411dcb...289b3/vat_ids/3fa85f64...2c963f66afa6' \
     -H 'X-Monite-Version: 2024-01-31' \
     -H 'X-Monite-Entity-Id: ENTITY_ID' \
     -H 'Authorization: Bearer ACCESS_TOKEN'

Overview

Supported VAT ID types

📘Need another VAT ID type?

Add new VAT ID

List all VAT IDs

Retrieve a VAT ID

Edit a VAT ID

Delete a VAT ID

📘
Need another VAT ID type?