> ## Documentation Index
> Fetch the complete documentation index at: https://docs.usecroma.com/llms.txt
> Use this file to discover all available pages before exploring further.

# ReTHUS

> Verifica si una persona está inscrita para ejercer una profesión de la salud en Colombia, por documento: títulos, actos que la autorizan y sanciones en ReTHUS.

Consulta a una persona en el Registro Único Nacional de Talento Humano en Salud
(ReTHUS), el registro del Ministerio de Salud de quienes están autorizados para
ejercer una profesión u ocupación de la salud en Colombia.

`POST /co/rethus/health-professional/v1` [Live](https://docs.usecroma.com/es/live-lookups.md)

| Campo | Tipo | Notas |
| - | - | - |
| `document_type` | enum | `CC`, `CE`, `TI` o `PPT`. Por defecto `CC`. |
| `document_number` | string | **Obligatorio.** Número de documento, de 5 a 12 dígitos. |

```bash theme={"dark"}
curl https://api.croma.run/co/rethus/health-professional/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "document_type": "CC", "document_number": "1234567890" }'
```

La respuesta repite el documento consultado y lista lo que el registro tiene a su nombre:

| Campo | Notas |
| - | - |
| `found` | `false` cuando el documento no está en el registro; en ese caso los campos de identidad son `null` y las listas están vacías. |
| `full_name` | Nombres y apellidos en el registro, o `null` cuando no se encuentra. |
| `first_name` / `middle_name` / `first_last_name` / `second_last_name` | Las partes del nombre tal como las guarda el registro; `null` cuando no hay. |
| `identity_status` | Estado del documento de identidad según el registro, por ejemplo `Vigente` o `Fallecido`. |
| `titles[]` | Una entrada por cada título con el que la persona está inscrita: `program_type` (por ejemplo `UNV`, `AUX`), `title_origin` (por ejemplo `Local`), `profession`, `practice_start_date` (`YYYY-MM-DD`), `administrative_act` y `reporting_entity`. |
| `social_service[]` | Registros del servicio social obligatorio, con las columnas que usa el registro. Vacío cuando no hay. |
| `sanctions[]` | Sanciones registradas, con las columnas que usa el registro. Vacío cuando no hay. |
| `checked_at` | Marca de tiempo ISO de cuándo se leyó la respuesta. |

> [!NOTE]
>
> Una persona puede tener varios títulos, por ejemplo uno de auxiliar y uno
> profesional posterior, cada uno autorizado por su propio acto administrativo.

> **[Referencia completa](https://docs.usecroma.com/es/api-reference/overview.md)**
>
> Esquemas, todos los campos de respuesta y un playground interactivo.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.