Endpoint: registro de talento humano en salud (RETHUS)

Con el documento de una persona verifica su inscripción en el Registro Único Nacional del Talento Humano en Salud (RETHUS): la base de MinSalud de médicos, enfermeras, odontólogos y demás profesionales del área de la salud autorizados para ejercer en Colombia. Devuelve los datos de la persona, su estado de identificación, las profesiones registradas (título, fecha de inicio, acto administrativo, entidad reportadora) y las prestaciones de servicios de salud declaradas (lugar, modalidad, fechas). Responde en segundos y no pide la fecha de expedición. Es el complemento del registro del profesional frente a la afiliación al sistema de /api/eps: esa dice dónde está asegurada la persona, esta si ejerce una profesión de la salud registrada.

POST/api/rethus1 crédito

La inscripción de una persona en el Registro Único Nacional del Talento Humano en Salud (RETHUS) de MinSalud, por documento, sin fecha de expedición. Responde la pregunta puntual "¿está inscrito como profesional de la salud?" con los datos de la persona, su estado de identificación, las PROFESIONES registradas (título, acto administrativo, entidad reportadora) y las prestaciones de servicios de salud declaradas (lugar, modalidad, fechas). Responde en segundos y es el complemento del registro del profesional frente a la afiliación al sistema de /api/eps: una dice dónde está asegurada la persona, la otra si ejerce una profesión de la salud registrada. ⚠️ Los tipos de documento son los del registro: solo CC, CE, PT (protección temporal) y TI. primerNombre y primerApellido son opcionales (el registro no los exige) y se reenvían tal cual. Una persona sin inscripción responde 404 y NO cobra. Cuesta 1 crédito.

Cuerpo de la solicitud

body (JSON)
{
  "docType": "CC",
  "docNumber": "1020304050"
}
Parámetros del cuerpo de la solicitud
CampoTipoQué es
docTypestringTipo de documento. Por defecto `CC`. Es el universo del registro: CE = Cédula de Extranjería, PT = Permiso por Protección Temporal (acepta `PPT` como alias), TI = Tarjeta de Identidad. No hay pasaporte ni registro civil en este registro. Con otro valor responde 400 `bad_request` sin cobrar.Valores: CC · CE · PT · TI
docNumberobligatoriostringNúmero de documento: de 1 a 12 caracteres, letras mayúsculas o dígitos (es el máximo que acepta el registro). Alias aceptados: `doc`, `documento`.
primerNombrestringOpcional. Primer nombre, tal como aparece en el documento. El registro no lo exige hoy y se reenvía tal cual; sirve de blinda por si el registro empieza a pedirlo. Máximo 12 caracteres. Alias: `nombre`.
primerApellidostringOpcional. Primer apellido, tal como aparece en el documento. Máximo 12 caracteres. Alias: `apellido`.
refreshbooleanIgnora la caché y vuelve a consultar la fuente oficial. Ojo: una consulta refrescada con datos siempre cobra (el hit de caché no).

Ejemplos por lenguaje

cURL
curl -X POST 'https://placapi.com/api/rethus' \
  -H 'x-api-key: pk_live_TU_CLAVE' \
  -H 'content-type: application/json' \
  -d '{"docType":"CC","docNumber":"1020304050"}'
JavaScript (fetch)
const res = await fetch("https://placapi.com/api/rethus", {
  method: "POST",
  headers: {
    "x-api-key": "pk_live_TU_CLAVE",
    "content-type": "application/json",
  },
  body: JSON.stringify({"docType":"CC","docNumber":"1020304050"}),
});
const data = await res.json();
Python (requests)
import requests

res = requests.post(
    "https://placapi.com/api/rethus",
    headers={"x-api-key": "pk_live_TU_CLAVE"},
    json={"docType":"CC","docNumber":"1020304050"},
)
data = res.json()

Respuesta exitosa

200 OK — ejemplo (placas y documentos ficticios)
{
  "source": "inscripcion-talento-humano-salud",
  "status": "info",
  "data": {
    "documento": "1020304050",
    "tipoDocumento": "CC",
    "inscrito": true,
    "persona": {
      "primerNombre": "MARIA FERNANDA",
      "segundoNombre": "",
      "primerApellido": "GOMEZ",
      "segundoApellido": "RUIZ",
      "estadoIdentificacion": "Vigente"
    },
    "profesiones": [
      {
        "tipoPrograma": "UNV",
        "origenObtencion": "Local",
        "profesion": "MEDICINA",
        "fechaInicioEjercer": "2019-03-10",
        "actoAdministrativo": "150573",
        "entidadReportadora": "COLEGIO MEDICO COLOMBIANO"
      }
    ],
    "prestacionesSSO": [
      {
        "tipoPrestacion": "Presto SSO",
        "tipoLugar": "Local",
        "lugar": "COLOMBIA|VALLE|SANTIAGO DE CALI",
        "fechaInicio": "2024-11-03",
        "fechaFin": "2025-11-02",
        "modalidad": "Prestación de Servicios Profesionales de Salud en IPS Habilitada",
        "programa": "Medicina",
        "entidadReportadora": "COLEGIO MEDICO COLOMBIANO"
      }
    ],
    "fechaConsulta": "2026-09-07→2:21:35 PM"
  },
  "mode": "live",
  "fetchedAt": "2026-07-24T15:04:05.000Z",
  "cost": 1
}

Errores y cobro

Cuesta 1 crédito cuando devuelve datos. Códigos posibles: 400 401 402 404 429 500 502 — qué significa cada uno, cuál reintentar y cuál cobra, en errores y rate limits. Autenticación por x-api-key: cómo generar la clave.

Última revisión: 7 de septiembre de 2026 · PlacApi opera desde Colombia. PlacApi no es una entidad oficial del Gobierno.

Contacto