Manage 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, while Canadian businesses have a BN (Business 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 | 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: 2023-06-04' \
-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: 2023-06-04' \
-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: 2023-06-04' \
-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: 2023-06-04' \
-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: 2023-06-04' \
-H 'X-Monite-Entity-Id: ENTITY_ID' \
-H 'Authorization: Bearer ACCESS_TOKEN'
Updated about 1 month ago