To validate a batch of Tax IDs, use the following URL and a GET method. Specify the Tax IDs that you want to check in the request's body.

https://{service_url}/api/v3/tax_numbers/validate

For example, you can use a POST method and the following URL:

https://tax-id-validator-bulk-api.sandbox.marketplace.taxamo.com/bulk/api/v3/tax_numbers/validate

The Tax IDs are specified in the body:

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

The response looks like this:

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

Details

Type	Value
Endpoint	`api/v3/tax_numbers/validate`
Method	POST

Body parameters

Field	Description
`input.tax_number`	Specify the Tax ID that you want to validate.
`input.tax_number.country_code`	Specify the country code to which the Tax ID belongs.

Response parameters

The following fields are returned by the request:

Field	Description
`items.id`	This is the Request ID and it can be used to identify the request that is associated with this validation request.

Example

Request

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

Response

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