# Eliminar (/docs/developers/api-reference/legal-entities/delete)

## Descripcion general [#descripcion-general]

Este endpoint realiza el **borrado** de la razón social y la retira de los listados de `GET`/`PATCH`/`DELETE` (las llamadas posteriores responden `404`). La respuesta exitosa es `204 No Content` con cuerpo vacío.

**No se puede eliminar mientras tenga empleos vinculados.** Si algún empleo (de cualquier estatus, **incluidos los dados de baja**) referencia esta razón social, el borrado se rechaza con `409` — primero debes reasignar esos empleos. Es intencional: los empleos dados de baja la siguen refiriendo por integridad histórica/SAT.

**El número no se reutiliza.** `legal_entity_number` de una razón social eliminada nunca se reasigna a una creación futura.

## Endpoint [#endpoint]

`DELETE https://app.integranom.com/api/v1/legal-entities/{legal_entity_number}`

**Path param:** `legal_entity_number` — entero positivo. Cualquier otro valor responde con `400`.

## Solicitud [#solicitud]

***

Sin cuerpo. La API responde `204 No Content` si el borrado tuvo éxito.

**cURL**

```bash
curl -X DELETE "https://app.integranom.com/api/v1/legal-entities/7" \
-H "Authorization: Bearer TU_API_KEY"
```

**Respuesta**

```text
204 No Content
```

## Comportamiento [#comportamiento]

* **Rechaza** con `409` si algún empleo referencia esta razón social (cualquier estatus, incluidos los dados de baja) — reasígnalos primero.
* Retira la razón social de los listados.
* La razón social deja de devolverse por `GET /api/v1/legal-entities`; las llamadas a `PATCH`/`DELETE` posteriores responden `404`.
* `legal_entity_number` no se reasigna a creaciones futuras.

## Errores [#errores]

| Status | Causa                                                                                                                                                                                     |
| ------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `400`  | `legal_entity_number` inválido en la URL (no es entero positivo). Cuerpo: `{ "message": "Invalid 'legal_entity_number' in URL: must be a positive integer." }`.                           |
| `404`  | La razón social no existe o ya fue eliminada. Cuerpo: `{ "message": "Legal entity not found." }`.                                                                                         |
| `409`  | La razón social sigue referenciada por uno o más empleos. Cuerpo: `{ "message": "This legal entity is still referenced by one or more employments. Reassign them before deleting it." }`. |
| `500`  | Error no manejado. Cuerpo: `{ "message": "Internal Server Error" }`.                                                                                                                      |