Tax data

Check a tax ID against the official format. Pro and Compliance

Checks the format (and the check digit where its algorithm is published). Does not confirm registration. The value is not stored or logged; to keep it out of URLs, use the MCP tool validate_tax_id_format, which sends it in the request body.

get/v1/countries/{country}/tax-id/validate

Request

  • Base URL: https://api.africacompliancedata.com
  • URL: https://api.africacompliancedata.com/v1/countries/{country}/tax-id/validate
  • Auth: one of:
    • API key in header x-api-key
    • HTTP bearer

Path parameters

countrystring required

ISO 3166-1 alpha-2 code, e.g. KE, NG, ZA.

Query parameters

valuestring required

Response

Result

countrystring required
country_namestring
coverage'ready' | 'partial' | 'gap' required
warningstring

When coverage is partial or gap, the year's holiday list is incomplete, or no value can be given

sourcesobject required
dataset_versionstring required
disclaimerstring required
identifierstring

Absent when the country publishes no format

input_lengthinteger

Only when no format is published

notesstring

Only when no format is published: what the authority says about the identifier

valid_formatboolean nullable

null when no official format is published

normalised_lengthinteger
check_digit_verifiedboolean
check_digit_methodstring
format_check'full' | 'partial'
messagestring

Changes

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