Guides · API

EU EORI number check API

EORI number validation for customs, logistics, import/export and e-commerce agents, live from the European Commission's EORI validation service: registered and valid or not, and the trader's name and address when the trader agreed to publish them. All EU member states (GB numbers are not covered).

0.003 USDC per call · GET /v1/eu/eori · free preview at /v1/eu/eori/preview

Parameters

Name	Required	Description
`eori`	yes	EU EORI customs number, e.g. IE6388047V

Example request

curl "https://factline.dev/v1/eu/eori?eori=IE6388047V"
# 402 Payment Required: pay with an x402 client (USDC on Base), or send
# Authorization: Bearer <your Factline API key>

Example response

{
  "eori": "IE6388047V",
  "valid": true,
  "status": "Valid",
  "name": null,
  "address": null,
  "checked": "2026-10-09",
  "explain": {
    "valid": "Registered and active in the EU EORI system (customs). Name and address appear only if the trader agreed to publish them. GB numbers are not covered (UK left the EU system)."
  },
  "source": "European Commission EORI validation service (EOS)"
}

Use it from an AI agent

Agents with an x402 wallet call the URL directly and pay per request. Assistants that speak MCP connect to https://factline.dev/mcp. Full reference: docs, OpenAPI, llms.txt. Businesses: API keys with a free trial.

Questions

How much does the EU EORI number check cost?

0.003 USDC per call, paid per request with x402 (no account), or included in a Factline API key plan with a free trial. Calls that fail are not charged.

Can I try it for free?

Yes: GET /v1/eu/eori/preview with the same parameters validates your input and shows what the paid answer contains, at no cost.

Where does the data come from?

Official public registers and open data, named with their licence in every response (source field) and at /.well-known/x402-license-provenance.