Look up EU VAT numbers over HTTP. No authentication required.
Rate limit: 100 requests per minute.

---

GET /api/v1/vat

Returns the latest cached result for a VAT number, fetching from EU VIES if not yet seen.

QUERY PARAMETERS

Parameter	Required	Description
vat	Yes	Full VAT number including country prefix, e.g. DE123456789. Whitespace and lowercase are normalised automatically.

EXAMPLE REQUEST

GET /api/v1/vat?vat=DE123456789

EXAMPLE RESPONSE

{
  "data": {
    "vat": "DE123456789",
    "country_code": "DE",
    "vat_number": "123456789",
    "is_valid": true,
    "name": "Example GmbH",
    "address": "Musterstraße 1, 10115 Berlin",
    "api_request_date": "2026-03-12+01:00",
    "error": null,
    "looked_up_at": "2026-03-12T10:00:00.000000Z"
  }
}

---

GET /api/v1/vat/{vat}/history

Returns all historical lookup records for a given VAT number, newest first.

URL PARAMETERS

Parameter	Description
vat	Full VAT number including country prefix, e.g. DE123456789. Whitespace and lowercase are normalised automatically.

EXAMPLE REQUEST

GET /api/v1/vat/DE123456789/history

EXAMPLE RESPONSE

{
  "data": [
    {
      "vat": "DE123456789",
      "country_code": "DE",
      "vat_number": "123456789",
      "is_valid": true,
      "name": "Example GmbH",
      "address": "Musterstraße 1, 10115 Berlin",
      "api_request_date": "2026-03-12+01:00",
      "error": null,
      "looked_up_at": "2026-03-12T10:00:00.000000Z"
    }
  ]
}

---

Error Responses

Status	Cause
422	Missing or invalid vat parameter.
200 with error field	The EU VIES service returned an error for this VAT number.