ErrorsAll codes
CITY_EMPTY
City cannot be empty
Category: Customers
Example response
When this error occurs, the API returns a JSON response with the following shape:
{
"type": "https://docs.beel.es/errors/CITY_EMPTY",
"title": "CITY_EMPTY",
"detail": "City cannot be empty",
"instance": "/v1/<resource>",
"errors": [],
"success": false,
"error": {
"code": "CITY_EMPTY",
"message": "City cannot be empty",
"details": {}
},
"meta": {
"timestamp": "2026-05-21T10:00:00Z",
"request_id": "4bf92f3577b34da6a3ce929d0e0e4736"
}
}The type URI is stable and always resolves to this page.
Message
City cannot be empty
La población no puede estar vacía
La població no pot estar buida
Send the request with Accept-Language: <es|en|ca> to receive the message in your preferred language.
Other errors in this category
ALTERNATIVE_ID_INVALID
The alternative identifier is not valid
ALTERNATIVE_ID_INVALID
Type NOT_REGISTERED (07) is only valid for Spain; received country: ''{0}''
ALTERNATIVE_ID_INVALID
For customers with country ES only types PASSPORT (03) or NOT_REGISTERED (07) are allowed
CITY_MAX_LENGTH
City cannot exceed {0} characters
CLIENT_DUPLICATE
A client with this NIF already exists