Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.numeral.com/llms.txt

Use this file to discover all available pages before exploring further.

Tax IDs can be stored on a merchant’s profile to identify the business for documentation and reporting purposes. They are set when creating or updating a merchant and are returned on the merchant object.
{
  "tax_ids": [
    {
      "type": "us-ein",
      "value": "12-3456789"
    }
  ]
}
A merchant can hold more than one tax ID — for example, a seller registered in both the US and the EU:
{
  "tax_ids": [
    { "type": "us-ein", "value": "12-3456789" },
    { "type": "de-vat", "value": "DE123456789" }
  ]
}

Supported Tax ID Types

TypeCountryDescriptionExample
us-einUnited StatesEmployer Identification Number12-3456789
gb-vatUnited KingdomVAT numberGB123456789
fr-vatFranceVAT numberFR12345678901
de-vatGermanyVAT numberDE123456789
at-vatAustriaVAT numberATU12345678
be-vatBelgiumVAT numberBE0123456789
bg-vatBulgariaVAT numberBG123456789
cy-vatCyprusVAT numberCY12345678L
cz-vatCzech RepublicVAT numberCZ12345678
dk-vatDenmarkVAT numberDK12345678
ee-vatEstoniaVAT numberEE123456789
fi-vatFinlandVAT numberFI12345678
gr-vatGreeceVAT numberEL123456789
hr-vatCroatiaVAT numberHR12345678901
hu-vatHungaryVAT numberHU12345678
ie-vatIrelandVAT numberIE1234567X
it-vatItalyVAT numberIT12345678901
lt-vatLithuaniaVAT numberLT123456789
lu-vatLuxembourgVAT numberLU12345678
lv-vatLatviaVAT numberLV12345678901
mt-vatMaltaVAT numberMT12345678
nl-vatNetherlandsVAT numberNL123456789B01
pl-vatPolandVAT numberPL1234567890
pt-vatPortugalVAT numberPT123456789
ro-vatRomaniaVAT numberRO12345678
se-vatSwedenVAT numberSE123456789012
si-vatSloveniaVAT numberSI12345678
sk-vatSlovakiaVAT numberSK1234567890
es-vatSpainVAT numberESA1234567Z
ch-vatSwitzerlandVAT numberCHE-123.456.789 MWST
no-vatNorwayVAT number123456789MVA
au-abnAustraliaAustralian Business Number12345678901
ca-bnCanadaBusiness Number123456789
in-gstIndiaGoods and Services Tax number12ABCDE3456FGZH
jp-cnJapanCorporate Number1234567890123
sg-gstSingaporeGST Registration NumberM12345678X
nz-gstNew ZealandGoods and Services Tax number123456789
za-vatSouth AfricaVAT number4123456789
br-cnpjBrazilCadastro Nacional da Pessoa Jurídica01.234.456/5432-10
mx-rfcMexicoRegistro Federal de ContribuyentesABC010101000