Counterpart VAT IDs

Learn which VAT IDs Monite supports and how to manage them.

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:

CountryTypeDescriptionExample
Australiaau_abnAustralian Business Number (AU ABN)51824753556
Australiaau_arnAustralian Taxation Office Reference Number518247535567
Austriaeu_vatEuropean VAT numberATU12345678
Belgiumeu_vatEuropean VAT numberBE0123456789
Brazilbr_cnpjBrazilian CNPJ number28.271.211/0001-88
Brazilbr_cpfBrazilian CPF number137.609.391-04
Bulgariabg_uicBulgaria Unified Identification Code123456789
Bulgariaeu_vatEuropean VAT numberBG0123456789
Canadaca_bnCanadian BN123456789
Canadaca_gst_hstCanadian GST/HST number123456789RT0002
Canadaca_pst_bcCanadian PST number (British Columbia)PST-1234-5678
Canadaca_pst_mbCanadian PST number (Manitoba)123456-7
Canadaca_pst_skCanadian PST number (Saskatchewan)1234567
Canadaca_qstCanadian QST number (Québec)1234567890TQ1234
Chilecl_tinChilean TIN12.345.678-K
Croatiaeu_vatEuropean VAT numberHR12345678912
Cypruseu_vatEuropean VAT numberCY12345678Z
Czech Republiceu_vatEuropean VAT numberCZ1234567890
Denmarkeu_vatEuropean VAT numberDK12345678
Estoniaeu_vatEuropean VAT numberEE123456789
European Unioneu_oss_vatEuropean One Stop Shop VAT number for non-Union schemeEU123456789
Finlandeu_vatEuropean VAT numberFI12345678
Franceeu_vatEuropean VAT numberFRAB123456789
Georgiage_vatGeorgian VAT123456789
Germanyeu_vatEuropean VAT numberDE123456789
Greeceeu_vatEuropean VAT numberEL123456789
Hong Konghk_brHong Kong BR number12345678
Hungaryhu_tinHungary tax number (adószám)12345678-1-23
Hungaryeu_vatEuropean VAT numberHU12345678912
Icelandis_vatIcelandic VAT123456
Indiain_gstIndian GST number12ABCDE3456FGZH
Indonesiaid_npwpIndonesian NPWP number12.345.678.9-012.345
Irelandeu_vatEuropean VAT numberIE1234567AB
Israelil_vatIsrael VAT12345
Italyeu_vatEuropean VAT numberIT12345678912
Japanjp_cnJapanese Corporate Number (Hōjin Bangō)1234567891234
Japanjp_rnJapanese Registered Foreign Businesses’ Registration Number (Tōroku Kokugai Jigyōsha no Tōroku Bangō)12345
Japanjp_trnJapanese Tax Registration Number (Tōroku Bangō)T1234567891234
Kenyake_pinKenya Revenue Authority Personal Identification NumberP000111111A
Latviaeu_vatEuropean VAT numberLV12345678912
Liechtensteinli_uidLiechtensteinian UID numberCHE123456789
Lithuaniaeu_vatEuropean VAT numberLT123456789123
Luxembourgeu_vatEuropean VAT numberLU12345678
Malaysiamy_frpMalaysian FRP number12345678
Malaysiamy_itnMalaysian ITNC 1234567890
Malaysiamy_sstMalaysian SST numberA12-3456-78912345
Maltaeu_vatEuropean VAT numberMT12345678
Mexicomx_rfcMexican RFC numberABC010203AB9
Netherlandseu_vatEuropean VAT numberNL123456789B12
New Zealandnz_gstNew Zealand GST number123456789
Norwayno_vatNorwegian VAT number123456789MVA
Polandeu_vatEuropean VAT numberPL1234567890
Portugaleu_vatEuropean VAT numberPT123456789
Romaniaeu_vatEuropean VAT numberRO1234567891
Russiaru_innRussian INN1234567891
Russiaru_kppRussian KPP123456789
Saudi Arabiasa_vatSaudi Arabia VAT123456789012345
Singaporesg_gstSingaporean GSTM12345678X
Singaporesg_uenSingaporean UEN123456789F
Slovakiaeu_vatEuropean VAT numberSK1234567891
Sloveniasi_tinSlovenia tax number (davčna številka)12345678
Sloveniaeu_vatEuropean VAT numberSI12345678
South Africaza_vatSouth African VAT number4123456789
South Koreakr_brnKorean BRN123-45-67890
Spaines_cifSpanish NIF number (previously Spanish CIF number)A12345678
Spaineu_vatEuropean VAT numberESA1234567Z
Swedeneu_vatEuropean VAT numberSE123456789123
Switzerlandch_vatSwitzerland VAT numberCHE-123.456.789 MWST
Taiwantw_vatTaiwanese VAT12345678
Thailandth_vatThai VAT1234567891234
Ukraineua_vatUkrainian VAT123456789
United Arab Emiratesae_trnUnited Arab Emirates TRN123456789012345
United Kingdomgb_vatUnited Kingdom VAT numberGB123456789
United Kingdomeu_vatNorthern Ireland VAT numberXI123456789
United Statesus_einFederal Tax Identification Number or United States EIN12-3456789

Need another VAT ID type?

You can request additional VAT ID types by sending an email to developers@monite.com.

Add new VAT ID

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

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

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

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

List all VAT IDs

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

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

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

1{
2 "data": [
3 {
4 "country": "DE",
5 "type": "eu_vat",
6 "value": "DE12345678",
7 "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
8 "counterpart_id": "411dcb68-dad8-46c2-92b9-f6ae445289b3"
9 }
10 ]
11}

Retrieve a VAT ID

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

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

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

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

Edit a VAT ID

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

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

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

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

Delete a VAT ID

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

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