Reference data

Validate a tax-ID / VAT number's format and check digit (offline, no registry lookup)

Pure algorithmic check of a business tax identifier or VAT number for one country on this brand: valid/invalid, the normalised form, the identifier type, the check level (checksum where the authority publishes the algorithm, format otherwise) and, when invalid, why (format, structure or checksum). Every rule cites its official source and as-of date. It does NOT confirm the number is registered or active: use the official_lookup link for that. A country with no sourced rule answers free with s...

get/v1/taxid/validate

Request

  • Base URL: https://mearef.dev
  • URL: https://mearef.dev/v1/taxid/validate
  • Auth: one of:
    • API key in header PAYMENT-SIGNATURE
    • API key in header X-PAYMENT
    • API key in header X-API-Key

Query parameters

countrystring required
idstring required

Response

Validation result (status 'covered'), or status 'unknown' (free) when no sourced rule exists for the country

countrystring
status'covered' | 'unknown'
validboolean nullable
normalisedstring nullable
id_typestring
check_level'checksum' | 'format'
reason_codestring nullable
reasonstring
sourcesobject[]
as_ofstring

Changes

No recorded changes to this operation across all 1 revision of this API.