{"uid":"cap_ngNUq7mMrojDAsUwXJGs8","slug":"402utils-eori-number-validator-b9ce6dc9","name":"402utils EORI Number Validator","description":"Validate an EU EORI number (the customs operator id for any EU import/export) against the Commission's official EOS service. Format is checked locally first, so junk never hits the network. Valid numbers return the registered name/address when the operator consented. Never a false 'invalid': if the service is down you get a 503, not charged. Complements vat-check in the EU compliance toolkit. ?attest=1 → Ed25519-signed.","url":"https://402utils.com/v1/eori-check?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["eori"],"properties":{"eori":{"type":"string","description":"EORI number, e.g. NL822502975 or DE1234567890123."},"attest":{"type":"string","description":"Set to 1 for an Ed25519-signed attestation of the result (audit trail)."}},"description":"Query param `eori` (country prefix + up to 15 alphanumerics)."}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["eori","valid","exists","checkedAt","source"],"properties":{"eori":{"type":"string"},"name":{"type":"string","description":"Registered name (only if the operator consented to publication)."},"valid":{"type":"boolean"},"exists":{"type":"boolean","description":"True iff the EORI is registered and active (equals valid)."},"reason":{"type":"string","description":"Present when valid=false due to local format: 'invalid_format'."},"source":{"type":"string","const":"EU-EOS"},"address":{"type":"string","description":"Registered address (only if consented)."},"country":{"type":"string","description":"ISO 3166 alpha-2 from the EORI prefix."},"checkedAt":{"type":"string","format":"date-time"},"attestation":{"type":"object","properties":{"alg":{"type":"string","const":"Ed25519"},"sig":{"type":"string","description":"base64url Ed25519 signature over the canonical JSON of payload."},"payload":{"type":"object","properties":{"ts":{"type":"string","format":"date-time"},"kid":{"type":"string","description":"Key id — matches a key in the .well-known document."},"endpoint":{"type":"string"},"resultSha256":{"type":"string","description":"SHA-256 of the canonical JSON of the result (attestation excluded)."}}}},"description":"Present only with ?attest=1. Ed25519 signature over the canonical result; verify against /.well-known/402utils-attestation.json."}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":{"p10Cents":"0.2000","medianCents":"0.2000","p90Cents":"0.2000","minCents":"0.2000","maxCents":"0.2000","p95Cents":"0.2000","sampleCount":1,"varies":false,"failureChargeRate":1},"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_o9OS8yQl0-0sPvQbM_KuP","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Validates an EU EORI number against the European Commission's official EOS service, returning registration status and optionally the operator's registered name and address.","exampleAgentPrompt":"Can you check whether EORI number NL822502975 is valid and registered with the EU customs system, and get back the operator's name if it's available?","exampleUseCases":null,"resultDescription":"Returns a JSON object with the EORI string, a boolean 'valid' flag, a boolean 'exists' flag, ISO 3166 country code, checkedAt timestamp, and source='EU-EOS'. If the operator consented to publication, also includes the registered business name and address. If format is invalid locally, returns valid=false with reason='invalid_format'. If the EU EOS service is unreachable, returns HTTP 503 (not charged). Optionally includes an Ed25519-signed attestation object with signature, key ID, timestamp, and SHA-256 of the result payload when attest=1 is set.","failureModes":["Invalid EORI format detected locally: returns valid=false with reason='invalid_format' before hitting the network","EU EOS service unavailable: returns HTTP 503, no charge applied","EORI not found in registry: returns valid=false, exists=false","Operator has not consented to data publication: name and address fields are absent from a valid/existing response","Malformed or missing 'eori' query parameter: likely returns 400 or validation error"],"whenToPreferThis":"Use this endpoint when you need to verify the authenticity and registration status of an EU EORI number for customs, import/export compliance, supplier onboarding, or audit purposes. Prefer it over manual VIES-only checks when the entity may be a customs operator rather than just a VAT-registered business. Use alongside the 402utils VAT check for comprehensive EU compliance validation. Choose the attest=1 option when you need a cryptographically signed audit trail of the check result.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-10T06:50:05.296Z","isFirstParty":false,"canonicalSlug":"402utils-eori-number-validator-b9ce6dc9"}