CANNOT_DELETE_PRIMARY
The account's primary company cannot be deleted.
Category: Companies
| HTTP status | 400 Bad Request |
| Retry | No |
When it happens
The company is the account's primary NIF, which cannot be deleted.
How to fix it
Nothing to retry: the primary company stays with the account.
Retry
Do not retry. The outcome is final: sending the same request again gets the same answer.
Returned by
The operations where this code is most likely. The list is not exhaustive.
Example response
When this error occurs, the API answers 400 Bad Request with a JSON body of this shape:
{
"type": "https://docs.beel.es/errors/CANNOT_DELETE_PRIMARY",
"title": "CANNOT_DELETE_PRIMARY",
"detail": "The account's primary company cannot be deleted.",
"instance": "/v1/<resource>",
"errors": [],
"success": false,
"error": {
"code": "CANNOT_DELETE_PRIMARY",
"message": "The account's primary company cannot be deleted.",
"details": {}
},
"meta": {
"timestamp": "2026-05-21T10:00:00Z",
"request_id": "4bf92f3577b34da6a3ce929d0e0e4736"
}
}The type URI is stable and always resolves to this page.
Message
Send the request with Accept-Language: <es|en|ca> to receive the message in your preferred language.
Other errors in this category
ACCOUNT_HAS_NO_HOLDER
The target account has no registered holder yet, so a NIF cannot be created on its behalf
CHECKOUT_REQUIRED
A payment method is required to create a production company
COMPANY_ACTIVE_IN_PRODUCTION
This company is active in Live and cannot be deleted. Deactivate it in Live first: the deactivation is scheduled, the current cycle is charged and served in full, and from its effective date you will be able to delete the company
COMPANY_HAS_INVOICES
This company has invoices in Live and cannot be deleted. Delete its drafts and proformas first; if it has already issued invoices, the way out is to deactivate it in Live, not to delete it
NIF_ALREADY_REGISTERED
The NIF is already registered