API
EORI & VAT validation, one API key.
Live EU data — TAXUD for EORI, VIES for VAT — as clean JSON. Metered, cached, and built for customs, logistics and onboarding workflows. Free tier, no card.
$ curl "https://eoricheck.com/v1/eori?number=IT00159560366" \ -H "Authorization: Bearer ek_live_your_key"↑ press Run for a live responseStart in 30 seconds
Generate a free key, send your first request. The same key validates both EORI and VAT. Usage and remaining quota come back as response headers and on /v1/usage.
- Official EU sources (TAXUD + VIES)
- 24h cache — fast, and gentle on the upstream
- Audit trail: source + timestamp on every result
Quickstart
Your first call in 2 minutes
Copy, paste, run. Issue a free key, then validate a VAT number or an EORI with it — one key does both. No SDK, no signup flow, no card.
Step 1 — get a key
# 1 · Get a free key — 100 validations/month, no card
curl -s https://eoricheck.com/api/keys \
-H 'content-type: application/json' \
-d '{"email":"you@company.com"}'
# → {"api_key":"ek_…","tier":"free","monthly_quota":100, …}Step 2 — make a call
# 2 · Validate a VAT number (EU VIES) — the same key also does EORI curl 'https://eoricheck.com/v1/vat?number=IE6388047V' \ -H 'Authorization: Bearer ek_your_key' # …or an EORI (EU TAXUD), same key: curl 'https://eoricheck.com/v1/eori?number=IT00159560366' \ -H 'Authorization: Bearer ek_your_key'
Base URL https://eoricheck.com · authenticate with Authorization: Bearer <key> or x-api-key. Every response carries your quota in X-Quota-* headers.
Reference
Endpoints
Base URL https://eoricheck.com · authenticate with Authorization: Bearer <key> or x-api-key.
/v1/eori?number=DE123456789012345Validate an EORI against EU TAXUD./v1/vat?number=IE6388047VValidate a VAT number against EU VIES./v1/usageYour current period usage and remaining quota./v1/monitoringList recurring EORI watches and plan allowance./v1/monitoring/watchesCreate a paid-plan EORI watch with an initial live TAXUD record.EORI response
{
"eori": "IT00159560366",
"country": "IT",
"estado": "valido",
"status_raw": "Valid",
"request_date": "08/07/2026",
"fuente": "taxud",
"checked_at": "2026-07-08T04:11:41.539Z"
}VAT response
{
"vat": "IE6388047V",
"country": "IE",
"estado": "valido",
"name": "GOOGLE IRELAND LIMITED",
"address": "3RD FLOOR, GORDON HOUSE, BARROW STREET, DUBLIN 4",
"fuente": "vies",
"checked_at": "2026-07-08T04:11:41.940Z"
}Metering headers (every response)
X-Plan: growth X-Quota-Limit: 25000 X-Quota-Used: 3412 X-Quota-Remaining: 21588 X-RateLimit-Limit: 120
Status codes
Fulfillment evidence
How you know a paid plan is active
A return URL is never treated as payment proof. Technical activation requires an authoritative Gumroad sale lookup and successful key provisioning. The email provider's request ID is not inbox-delivery proof; confirm the provisioning email arrived and verify the tier on /v1/usage.
Gumroad receipt
Shows the verified subscription, tier, amount and billing email.
Provisioning email
Contains the API key; provider acceptance alone does not prove inbox delivery.
Live usage proof
GET /v1/usage returns the active tier, quota, period and remaining calls.
GET /v1/usage
{
"tier": "growth",
"period": "2026-07",
"used": 3412,
"quota": 25000,
"remaining": 21588,
"rate_per_minute": 120
}The JSON above is a redacted sample of the fulfillment record shape; it contains no customer key or personal data.
Pricing
Simple, metered plans
Every plan validates both EORI and VAT from one key. Prices are in EUR. Configured plans open Gumroad checkout; unavailable plans collect a request only and do not charge or activate access.
Free
Kick the tyres. No card.
- 100 validations / month
- EORI + VAT from one key
- 10 requests / minute
- Live TAXUD + VIES data, 24h cache
Starter
For a single integration.
- 5,000 validations / month
- 60 requests / minute
- EORI + VAT from one key
- Dated CSV export with source + UTC
- 5 daily EORI watches + change alerts
- Email support
Growth
For a busy customs desk.
- 25,000 validations / month
- 120 requests / minute
- Batch CSV upload + dated report
- 50 daily EORI watches + change alerts
- Priority email support
Scale
For platforms and brokers.
- 100,000 validations / month
- 300 requests / minute
- Bulk + PDF verification records
- 250 EORI watches · checks every 6 hours
- SLA available on request
Buttons that open Gumroad start a secure checkout. A “Request” button only sends your contact request; it does not activate a subscription or take payment. Paid plans renew monthly and can be cancelled in Gumroad; after cancellation the key returns to Free limits.
No code? Validate a spreadsheet.
Upload a CSV of EORI numbers and download a dated evidence report.
Open the batch toolNeed to know when validity changes?
Add a watchlist, run scheduled live TAXUD checks and receive change alerts.
Open EORI monitoring