To validate a tax number, use the following URL and the GET method:

{service_url}/api/v3/tax_numbers/{tax_id}/validate?country_code={country_code}&country_subdivision_code={country_subdivision_code}&business_name={business_name}&cache_expiry_timeout_days={cache_value}&on_error={error_behavior}'

Here, {service_url} is the URL of the sandbox or production environment. Additionally:

• {tax_id} is the tax number to validate.
• {country_code} is the two-letter ISO country code associated with the tax number.
• {country_subdivision_code} is the country subdivision code associated with the tax number.
• {business_name} is the name of the business or individual associated with the tax number.
• {cache_value} is the maximum age, in days, of a cached validation result. Specify 0 to perform a real-time validation against the tax authority. Specify a higher value, such as 30, to allow the service to use a validation result cached within that period.

Details

Input parameters

For more information, see Vertex Validator API Fields Reference.

Output parameters

For more information, see Vertex Validator API Fields Reference.

Request example

{
  "items": [
    {"input": {"tax_number": "000000000", "country_code": "PL"}},
    {"input": {"tax_number": "111111111", "country_code": "GB"}},
    ...

Response example

{
    "items": [
        {
            "id": "ANKpMhAXMAA="
        },
        {
            "id": "ANKpMhAYMAA="
        },
        ...
    ]