tax

Validate a European Union VAT number against the official...

Validate a European Union VAT number against the official VIES (VAT Information Exchange System) register in real time. Confirms whether the VAT identifier is currently registered for intra-EU trade and, when the member state discloses them, returns the registered business name and address. Covers the 27 EU member states (Greece as EL) plus Northern Ireland (XI); Great Britain (GB) is not in VIES. Pass either a full identifier (vat=DE811569869) or country + number. Returns {valid, countryCode, vatNumber, name, address, requestDate, reason}. When a member-state register is temporarily down, returns a retryable 503 rather than a false negative. Data from the European Commission VIES service.

get/api/tax/vat

Request

  • Base URL: https://2s.io
  • URL: https://2s.io/api/tax/vat
  • Auth: API key in header PAYMENT-SIGNATURE

Query parameters

vatstring

Full VAT identifier: 2-letter country prefix + number, e.g. "DE811569869" or "NL810433941B01" (spaces/dots/hyphens allowed).

countrystring

2-letter VAT country prefix, e.g. "DE". Greece is EL (GR also accepted); Northern Ireland is XI. Use with number.

numberstring

The VAT number without the country prefix, e.g. "811569869". Use with country.

trial1

Try before you buy. Set to 1 for one free real call per endpoint per hour — no wallet or payment needed — to verify the endpoint before paying. Equivalent to sending the "X-2s-Trial: 1" request header. Listed only on operations that offer a trial; the others always answer 402.

Response

(unresolved $ref)

Changes

No recorded changes to this operation across all 1 revision of this API.