GET {service-url}/bulk/api/v3/tax_numbers/validate?{last-seen-id}

where:

• {service-url} is the URL of the service.
• {last-seen-id} is thee ID from theitems.id field (that is returned in the response from the Poll Results request).

Restrictions

This request only returns processed validations so each request may return more results than the previous until processing is complete.

Details

Query parameter

Example

Request

The following request specifies CMGpMhACMAA as the Last Seen ID:

https://tax-id-validator-bulk-api.sandbox.marketplace.taxamo.com/GET bulk/api/v3/tax_numbers/validate?last-seen-id=CMGpMhACMAA=

Response

{
    "items": [
        {
            "status": "processed",
            "request_id": "ANKpMhAXMAA=",
            "id": "CMGpMhACMAA=",
            "output": {
                "buyer_tax_number_valid": false,
                "buyer_tax_number_format_valid": false,
                "buyer_tax_number_validation_info": "tax-number-syntax-invalid"
            }
        },
        {
            "status": "processed",
            "request_id": "ANKpMhAYMAA=",
            "id": "CMGpMhAFMAA=", 
            "output": {
                "buyer_tax_number_valid": false,
                "buyer_tax_number_format_valid": true,
                "buyer_tax_number_validation_info": "tax-number-invalid-according-to-external-service",
                "buyer_tax_number_normalized": "111111111",
                "buyer_tax_number_service_cache_used": true,
                "buyer_tax_number_service_cache_timestamp": "2025-08-20T15:07:34Z",
                "tax_number_service": "tax.service.gov.uk.api"
            }
        }
    ]
}