Batch Validation

Get batch job status and results

Changed on

Poll the status of a previously submitted batch job. Results are included in the response once processing is complete.

get/v1/batch/{batch_id}

Request

Path parameters

batch_idstring required

Query parameters

api_keystring nullable

API key as a query parameter (prefer the X-API-Key header)

Headers

x-api-keystring nullable

API key for authentication

x-rapidapi-proxy-secretstring nullable

RapidAPI marketplace proxy secret (internal)

Response

Successful Response

batch_idstring required
statusstring required
total_itemsinteger required
completed_itemsinteger required

Example response

{
  "batch_id": "batch_x7k9m2",
  "status": "completed",
  "total_items": 2,
  "completed_items": 2,
  "results": [
    {
      "vat_number": "DE121132589",
      "country_code": "DE",
      "company_name": "Acme GmbH",
      "company_address": "Musterstr. 1, 10115 Berlin",
      "request_id": "req_abc123",
      "consultation_number": "WAPIAAAAYrPwzsPc",
      "registration": {
        "vat_registered_from": "2000-07-01"
      },
      "meta": {
        "response_time_ms": 142,
        "last_verified": "2026-03-21T10:15:30Z",
        "upstream_status": "ok"
      }
    }
  ]
}

Changes