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_AND_NIF_EXCLUSIVE
The customer cannot carry both a NIF and an alternative identifier. Use only one
ALTERNATIVE_ID_INVALID
The alternative identifier is not valid
ALTERNATIVE_ID_REQUIRES_SPAIN
Type NOT_REGISTERED (07) is only valid for Spain; received country: ''{0}''
ALTERNATIVE_ID_SPAIN_INVALID_TYPE
For customers with country ES only types PASSPORT (03) or NOT_REGISTERED (07) are allowed
BULK_VALIDATION_ERROR
One or more customers in the batch are invalid; none were created