European Union API: Validate EU VAT number
Checks an EU VAT number in the European Commission's VIES service and returns whether it is valid, with the registered name and address when the country makes them available.
Unofficial. Not affiliated with or endorsed by European Union.
Inputs
Values from the run on Oct 31, 2026, shown under Output.
- Country optional
country Country name or two-letter VAT code when the number has no prefix; for example Ireland or IE.
Not set
- Vat Number, required
vat_number VAT number as shown on an invoice, with or without country prefix, spaces, dots or dashes; for example IE6388047V.
IE6388047V
Input as JSON
{ "vat_number": "IE6388047V"}Output
{ "note": null, "valid": true, "address": "3RD FLOOR, GORDON HOUSE, BARROW STREET, DUBLIN 4", "country": "Ireland", "page_url": "https://ec.europa.eu/taxation_customs/vies/" , "checked_at": "2026-09-28T23:02:28.713000+00:00", "vat_number": "IE6388047V", "registered_name": "GOOGLE IRELAND LIMITED", "raw_service_status": "VALID", "request_identifier": null}Code
curl https://api.fous.com/v1/runs \ -H "Authorization: Bearer $FOUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"method":"ec.europa.eu/validate_vat_number","input":{"vat_number":"IE6388047V"}}' # Save as fous.py, then run: python3 fous.pyimport json, os, timefrom urllib.error import HTTPErrorfrom urllib.request import Request, urlopenAPI = "https://api.fous.com/v1/runs" KEY = os.environ["FOUS_API_KEY"]HEADERS = { "Authorization": f"Bearer {KEY}", "Content-Type": "application/json" ,}def call(url, body=None): data = json.dumps(body).encode() if body else None request = Request(url, data, HEADERS) try: with urlopen(request, timeout=120) as r: return r.status, json.load(r) except HTTPError as error: message = json.load(error)["error"]["message"] raise RuntimeError(message) from errorstatus, run = call(API, { "method": "ec.europa.eu/validate_vat_number" , "input": { "vat_number": "IE6388047V" }})# 202: still going after 30 s. Ask again until it ends.while status == 202: time.sleep(2) status, run = call(f"{API}/{run['id']}")print(json.dumps(run["data"], indent=2))// Save as fous.mjs, then run: node fous.mjsconst api = "https://api.fous.com/v1/runs" ;const headers = { Authorization: `Bearer ${process.env.FOUS_API_KEY}`, "Content-Type": "application/json" ,};let response = await fetch(api, { method: "POST", headers, body: JSON.stringify({ "method": "ec.europa.eu/validate_vat_number" , "input": { "vat_number": "IE6388047V" } }), signal: AbortSignal.timeout(120_000),});let run = await response.json();// 202: still going after 30 s. Ask again until it ends.while (response.status === 202) { await new Promise((done) => setTimeout(done, 2_000)); response = await fetch(`${api}/${run.id}`, { headers }); run = await response.json();}if (!response.ok) throw new Error(run.error.message);console.log(run.data);# Connect your agent to Fous once, over MCP (Streamable HTTP):# https://api.fous.com/mcp# Set FOUS_API_KEY first: create a key at https://app.fous.com/keys.# Claude Codeclaude mcp add \ --scope user \ --transport http fous https://api.fous.com/mcp \ --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"# Codexcodex mcp add fous \ --url https://api.fous.com/mcp \ --bearer-token-env-var FOUS_API_KEY# Cursor, VS Code, Windsurf, Cline and morenpx -y add-mcp https://api.fous.com/mcp -g -n fous \ --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"# Then ask your agent:# "Use Fous to run ec.europa.eu/validate_vat_number# with {"vat_number":"IE6388047V"}"Over HTTP, the answer’s data holds the output. A run still going after 30 seconds answers 202 with its id: ask GET /v1/runs/{id} until it ends.
Schema
Input schema
{ "type": "object", "required": [ "vat_number" ], "properties": { "country": { "type": "string", "description": "Country name or two-letter VAT code when the number has no prefix; for example Ireland or IE." }, "vat_number": { "type": "string", "description": "VAT number as shown on an invoice, with or without country prefix, spaces, dots or dashes; for example IE6388047V." } }}Output schema
{ "type": "object", "required": [ "valid", "country", "vat_number", "registered_name", "address", "checked_at", "note", "page_url", "request_identifier", "raw_service_status" ], "properties": { "note": { "type": [ "string", "null" ], "description": "Reason the check could not be completed, if any." }, "valid": { "type": [ "boolean", "null" ], "description": "Whether VIES confirms this VAT number; null if validation could not be completed." }, "address": { "type": [ "string", "null" ], "description": "Registered address if made available by the country." }, "country": { "type": "string", "description": "Country where the VAT number is registered." }, "page_url": { "type": "string", "description": "European Commission VIES validation page." }, "checked_at": { "type": "string", "format": "date-time", "description": "Time of the VIES check with timezone." }, "vat_number": { "type": "string", "description": "VAT number without punctuation, including the country prefix." }, "registered_name": { "type": [ "string", "null" ], "description": "Registered name if made available by the country." }, "raw_service_status": { "type": "string", "description": "Original VIES service status.", "x-fous-developer": true }, "request_identifier": { "type": [ "string", "null" ], "description": "VIES request identifier when issued.", "x-fous-developer": true } }, "additionalProperties": false}- Price
- 1 credit per completed run (1¢ with pay as you go); failed runs are free.
- Method
ec.europa.eu/validate_vat_number- Returns
- valid, country, vat_number, registered_name, address, checked_at, note
Use it from your agent
Give your agent this line. It reads SKILL.md, gets a Fous API key and connects the Fous MCP server. Its run then takes the method ec.europa.eu/validate_vat_number with the inputs above.
Ask your agent
- Can you check whether the VAT number DE 129 273 398 on this supplier invoice is actually valid?
- Look up FR40303265045 in the europa.eu VIES system and tell me the registered company name and address
- Is NL859048123B01 a real, active EU VAT registration? I need to confirm before invoicing reverse charge.
- Verify Italian VAT number 00743110157 for me — country is Italy, the invoice shows it without the IT prefix
- Using the European Commission VIES service on europa.eu, confirm if ESB-12345678 from Spain is registered and who it belongs to
See more
All European Union methodsFinds recently published EU procurement notices matching what is being bought, with buyer, estimated value, submission deadline and TED notice link. Open-only results must have a future submission deadline.
ted.europa.eu/search_tendersFinds published EU contract award notices on Tenders Electronic Daily by contract topic or winning company, newest publication first, optionally limited to a buyer country and a start date. Values and tender counts are included when published; counts across lots are summed.
ted.europa.eu/search_contract_awardsLooks up an official Eurostat statistic for an EU or EEA country and the EU27 figure for the same period. Quarterly and half-yearly series return the reporting period that contains a requested month.
ec.europa.eu/get_statisticSearches EUR-Lex legal acts by topic, ranked by the site's relevance, filtered by document type, year of adoption and in-force status. Short names and ELI links are included when shown in the results.
eur-lex.europa.eu/search_eu_lawGets the official text and key dates of one article of an EU regulation or directive from EUR-Lex, in the latest consolidated version when there is one, in any official EU language.
eur-lex.europa.eu/get_law_articleConverts an amount between currencies using ECB euro reference rates, including euro and cross-currency conversions. Uses the latest preceding published rate when the date has none.
ecb.europa.eu/convert_currencyGets the official ECB euro reference exchange rates for a day, or the latest published day. Weekends, holidays and dates before publication return the previous published day.
ecb.europa.eu/get_euro_exchange_ratesReturns the ECB's current deposit facility, main refinancing operations and marginal lending facility rates with their effective date. Optionally includes earlier rate changes, newest first.
ecb.europa.eu/get_key_interest_rates