API del RETHUS: verificar un profesional de la salud por documento

El RETHUS es el registro único nacional del talento humano en salud: quién puede ejercer legalmente una profesión sanitaria en Colombia. PlacApi lo consulta por documento y devuelve en JSON la profesión, el número de registro y la fecha, para que contratar a un profesional de la salud no dependa de que alguien abra un portal y lea una tabla.

Probar en el sandbox y generar API keyVer precios por consulta

¿No eres desarrollador? Consulta el RUNT por placa aquí sin escribir código.

Qué problema resuelve

Contratar a un médico, enfermero, odontólogo o terapeuta sin verificar el RETHUS es un riesgo legal y clínico. La consulta oficial es un formulario del SISPRO que no se puede automatizar desde un sistema propio; este endpoint la vuelve una llamada JSON.

Para quién sirve

IPS, clínicas y hospitales que verifican antes de vincular, empresas de servicios temporales del sector salud, aseguradoras, plataformas de telemedicina y agregadores de citas, y áreas de talento humano que deben dejar constancia de la verificación.

Datos requeridos

  • docType — tipo de documento (CC, CE, PA…). Por defecto CC.
  • docNumber — número de documento del profesional.

Fuentes y cobertura

  • RETHUS — Registro Único Nacional del Talento Humano en SaludRegistro del Ministerio de Salud con las profesiones y especialidades habilitadas para ejercer, y su número de inscripción.

¿Cómo verificar por API si alguien es profesional de la salud?

Con un POST a /api/rethus enviando docType y docNumber. La respuesta dice si está en el registro y con qué profesiones o especialidades.

¿El RETHUS garantiza que puede ejercer hoy?

Dice que está inscrito para ejercer esa profesión. No sustituye la revisión de antecedentes disciplinarios ni la verificación de su vinculación laboral.

Ejemplo de solicitud

POST https://placapi.com/api/rethus. Autenticación por API key en el header x-api-key. Los datos del ejemplo son ficticios.

Ejemplo cURL de la solicitud
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"}'

Ejemplo de respuesta

Respuesta JSON (fragmento con los campos de esta consulta; la API integral devuelve todas las fuentes en el mismo objeto).

Ejemplo de respuesta JSON
{
  "source": "rethus",
  "status": "info",
  "data": {
    "documento": "1020304050",
    "tipoDocumento": "CC",
    "registrado": true,
    "nombre": "JUAN CARLOS PEREZ GOMEZ",
    "registros": [
      {
        "profesion": "MEDICINA",
        "numeroRegistro": "12345",
        "fechaRegistro": "2015-06-30"
      }
    ]
  }
}

Explicación campo por campo

CampoTipoDescripción
registradobooleantrue si el documento aparece en el RETHUS.
registrosarrayUna entrada por profesión o especialidad inscrita: quien tiene título y especialización trae varias.
registros[].profesionstringProfesión u ocupación tal como la nombra el registro.

Tiempo de respuesta

Segundos. Consulta directa contra el registro, sin navegador.

Precio y cobro

1 crédito por consulta con datos, desde 349 COP. El precio por crédito baja por volumen: 349 COP desde 30, 249 COP desde 1.000, 149 COP desde 5.000, 139 COP desde 10.000, 119 COP desde 20.000, 99 COP desde 50.000. Los créditos se compran por adelantado (mínimo 30 = 10.470 COP), no vencen y no hay mensualidad. El mismo precio aplica por la web y por API. Solo se cobra cuando la consulta devuelve datos; por API, las consultas sin resultado (404) tienen 10 gratis al mes por cada tipo de respuesta sin datos y después cobran igual.

Caché y actualización

30 días. Una inscripción en el RETHUS se mueve muy poco.

Seguridad y privacidad

La placa y el documento se usan solo para ejecutar la consulta; el resultado queda en caché temporal. No se almacenan datos de tarjetas (los pagos los procesa Wompi). Ver privacidad y seguridad.

Limitaciones y posibles errores

  • El RETHUS dice que la persona está inscrita para ejercer; no dice si está activa en un empleo, ni evalúa su desempeño.
  • Un documento que no aparece responde 404 sin cobrar. Puede ser que la persona no sea profesional de la salud, o que su inscripción aún no se refleje.
  • No sustituye la verificación de antecedentes disciplinarios del ejercicio profesional, que va por /api/antecedentes-disciplinarios.

Códigos de error del endpoint (401, 402, 429, 5xx) en la referencia de errores.

Otras preguntas frecuentes

¿Qué pasa si la persona no aparece?

+

Se responde 404 y no se cobra. Puede ser que no sea profesional de la salud o que su inscripción no esté reflejada todavía.

Seguir explorando

Última revisión: 7 de septiembre de 2026 · Versión de la API: v1 · Fuentes y metodología

Contacto