invalid_eori_format

Example response

{
  "error": {
    "code": "invalid_eori_format",
    "message": "Invalid EORI number format: GB123. GB EORI numbers are GB followed by 12 to 15 digits",
    "docs_url": "https://docs.avatcado.com/errors/invalid_eori_format",
    "eori_number": "GB123"
  },
  "meta": {
    "request_id": "550e8400-e29b-41d4-a716-446655440000"
  }
}

What happened?

How to fix

1. Include the country prefix: GB123456789000, NL123456789, XI123456789000
2. Send the EORI number, not the VAT number: a GB VAT number has 9 digits, a GB EORI number has 12 to 15. GB123456789 fails here; the EORI number for that trader is usually GB123456789000
3. Let the API normalize: send gb 123.456.789 000 as typed. Spaces, dots, dashes and casing are handled for you

# Correct
curl "...?eori_number=GB123456789000"
curl "...?eori_number=nl+123.456.789"

# Wrong: a 9-digit GB VAT number
curl "...?eori_number=GB123456789"

# Wrong: no country prefix
curl "...?eori_number=123456789000"

# Wrong: a country with no EORI register behind this endpoint
curl "...?eori_number=CH123456789"

Common mistakes

• Sending a VAT number: use GET /v1/validate for VAT numbers. The two registers are separate
• Dropping a leading zero: many Belgian numbers start with one (BE0123456789). Keep the number as issued
• Using EL for Greece: this works. Greek EORI numbers are issued with GR, and a number sent with the VAT prefix EL is rewritten to GR for you
• Sending a Swiss, Norwegian or other non-EU number: only numbers issued by an EU member state or the UK can be checked

Related errors

• missing_parameter: the eori_number parameter was not provided at all
• upstream_unavailable: the number is well-formed and the register is down