INVALID_IBAN

Example response

When this error occurs, the API returns a JSON response with the following shape:

{
  "type": "https://docs.beel.es/errors/INVALID_IBAN",
  "title": "INVALID_IBAN",
  "detail": "The IBAN format is not valid. It must start with the country code and be 15 to 34 characters long (e.g. ES9121000418450200051332)",
  "instance": "/v1/<resource>",
  "errors": [],
  "success": false,
  "error": {
    "code": "INVALID_IBAN",
    "message": "The IBAN format is not valid. It must start with the country code and be 15 to 34 characters long (e.g. ES9121000418450200051332)",
    "details": {}
  },
  "meta": {
    "timestamp": "2026-05-21T10:00:00Z",
    "request_id": "4bf92f3577b34da6a3ce929d0e0e4736"
  }
}

The type URI is stable and always resolves to this page.

Message

The IBAN format is not valid. It must start with the country code and be 15 to 34 characters long (e.g. ES9121000418450200051332)

El IBAN no tiene un formato válido. Debe empezar por el código de país y tener entre 15 y 34 caracteres (ej: ES9121000418450200051332)

L''IBAN no té un format vàlid. Ha de començar pel codi de país i tenir entre 15 i 34 caràcters (ex: ES9121000418450200051332)

Send the request with Accept-Language: <es|en|ca> to receive the message in your preferred language.

Other errors in this category

ACTIVE_CANNOT_DELETE

Cannot delete an active series. Deactivate it first

DEFAULT_CANNOT_DEACTIVATE

Cannot deactivate the default series. Set another series as default first

DEFAULT_CANNOT_DELETE

Cannot delete the default series. Set another series as default first

FISCAL_IDENTITY_LIVE_ONLY

This company is live. In Test mode you can only change how the invoice looks (logo, colour, template and languages). Fiscal details are edited in Live mode