ErrorsAll codes
NIF_ALREADY_REGISTERED
The NIF is already registered
Category: Companies
Example response
When this error occurs, the API returns a JSON response with the following shape:
{
"type": "https://docs.beel.es/errors/NIF_ALREADY_REGISTERED",
"title": "NIF_ALREADY_REGISTERED",
"detail": "The NIF is already registered",
"instance": "/v1/<resource>",
"errors": [],
"success": false,
"error": {
"code": "NIF_ALREADY_REGISTERED",
"message": "The NIF is already registered",
"details": {}
},
"meta": {
"timestamp": "2026-05-21T10:00:00Z",
"request_id": "4bf92f3577b34da6a3ce929d0e0e4736"
}
}The type URI is stable and always resolves to this page.
Message
The NIF is already registered
El NIF ya está registrado
El NIF ja està registrat
Send the request with Accept-Language: <es|en|ca> to receive the message in your preferred language.
Other errors in this category
CANNOT_DELETE_PRIMARY
Cannot delete the primary account through this endpoint
COMPANY_NOT_FOUND
Company not found
MAX_PROFILES_REACHED
You have reached the maximum number of business profiles ({0}). Upgrade your plan for more
PROFILE_NOT_FOUND
Business profile not found
PROFILE_NOT_OWNED
The business profile does not belong to your account