Colombia — RETHUS (registro de talento humano en salud)

Verifik valida la identidad y consulta RETHUS (Registro Único Nacional de Talento Humano en Salud) con documentType y documentNumber. El flujo resuelve primero el ciudadano y luego RETHUS para estado del registro, formación académica y filas de prestaciones / seguridad social (SSO) cuando la fuente las devuelve.

Qué devuelve la API

• Campos de identidad del ciudadano emparejado
• rethus.status — texto de estado en la grilla RETHUS
• rethus.academic — títulos / formación cuando existan
• rethus.dataSSO — prestaciones, modalidades y entidades cuando existan
• Respuesta firmada por Verifik

Referencia de API

Endpoint

GET https://api.verifik.co/v2/co/cedula/rethus

Los mismos campos pueden enviarse en POST con cuerpo JSON. GET usa parámetros de consulta como abajo.

Resumen: documentType, documentNumber.

Headers

Name	Value
Accept	application/json
Authorization	Bearer <token>

Parámetros

name	type	required	description
documentType	string	sí	Uno de CC, CE, PPT.
documentNumber	string	sí	Número sin espacios ni signos (5–15 caracteres).

Solicitud

JavaScript

import axios from "axios";

const { data } = await axios.get("https://api.verifik.co/v2/co/cedula/rethus", {
	params: {
		documentType: "CC",
		documentNumber: "123456789",
	},
	headers: {
		Accept: "application/json",
		Authorization: `Bearer ${process.env.VERIFIK_TOKEN}`,
	},
});
console.log(data);

Python

import os, requests

url = "https://api.verifik.co/v2/co/cedula/rethus"
headers = {"Accept": "application/json", "Authorization": f"Bearer {os.getenv('VERIFIK_TOKEN')}"}
params = {"documentType": "CC", "documentNumber": "123456789"}
r = requests.get(url, headers=headers, params=params)
print(r.json())

Respuesta

200

{
	"data": {
		"documentType": "CC",
		"documentNumber": "123456789",
		"firstName": "MARIA",
		"lastName": "GOMEZ LOPEZ",
		"fullName": "MARIA GOMEZ LOPEZ",
		"rethus": {
			"status": "ACTIVO EN RETHUS",
			"academic": [
				{
					"type": "Pregrado",
					"originDegree": "Nacional",
					"profession": "MÉDICO GENERAL",
					"startDate": "01/01/2010",
					"administrativeAct": "…",
					"entity": "…"
				}
			],
			"dataSSO": []
		}
	},
	"signature": {
		"dateTime": "January 16, 2024 3:44 PM",
		"message": "Certified by Verifik.co"
	}
}

404

{
	"code": "NotFound",
	"message": "Record not found."
}

409

{
	"code": "MissingParameter",
	"message": "documentType must be one of [CC, CE, PPT]"
}

Características

• Tipos aceptados en validación: CC, CE, PPT
• Sin fecha de expedición obligatoria
• GET y POST comparten el mismo manejador

Casos de uso

• Habilitación de personal de salud
• Cumplimiento normativo y auditoría

Notas

• La consulta RETHUS ocurre después de emparejar al ciudadano; si no hay coincidencia, puede devolverse 404 u otros errores.
• academic y dataSSO pueden ser arrays vacíos.
• Los datos son personales y sensibles; úsalos según la ley colombiana de habeas data en salud.