Colombia โ RETHUS (health professionals registry)
Verifik confirms identity against RETHUS (Registro รnico Nacional de Talento Humano en Salud) using documentType and documentNumber. The flow first resolves the person via the Colombian citizen lookup, then queries RETHUS for registry status, academic qualifications, and social security / benefit (SSO) rows when the source returns them.
Use this endpoint for credentialing, compliance, and workforce checks where RETHUS data is permitted.
What this API returnsโ
- Identity fields from the underlying citizen match (name parts, document type/number)
rethus.statusโ registry status text from the RETHUS result gridrethus.academicโ array of academic/professional rows (type, degree origin, profession, dates, entity, etc.) when presentrethus.dataSSOโ benefit / modality / entity rows when present- A signed Verifik response
API referenceโ
Endpointโ
GET https://api.verifik.co/v2/co/cedula/rethus
Same fields may be sent in a POST JSON body. GET uses query parameters as below.
Query-only summary: documentType, documentNumber.
Headersโ
| Name | Value |
|---|---|
| Accept | application/json |
| Authorization | Bearer <token> |
Parametersโ
| name | type | required | description |
|---|---|---|---|
documentType | string | yes | One of CC, CE, PPT. |
documentNumber | string | yes | Document number without spaces or punctuation (length 5โ15). |
Requestโ
- JavaScript
- Python
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);
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())
Responseโ
- 200
- 404
- 409
{
"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": [
{
"typeBenefit": "โฆ",
"typePlaceBenefit": "โฆ",
"placeBenefit": "โฆ",
"startDate": "โฆ",
"endDate": "โฆ",
"modalityBenefit": "โฆ",
"programBenefit": "โฆ",
"entity": "โฆ"
}
]
}
},
"signature": {
"dateTime": "January 16, 2024 3:44 PM",
"message": "Certified by Verifik.co"
}
}
{
"code": "NotFound",
"message": "Record not found."
}
{
"code": "MissingParameter",
"message": "documentType must be one of [CC, CE, PPT]"
}
Featuresโ
- Document types accepted by validation: CC, CE, PPT
- No issue date required (unlike some other Colombian endpoints)
- GET and POST share the same handler
Use casesโ
- Hospital and clinic credentialing
- Regulatory and insurance checks on health professionals
Notesโ
- RETHUS is queried after a successful citizen match; if the person cannot be resolved upstream, you may see 404 or other errors.
rethus.academicandrethus.dataSSOmay be empty arrays when the portal returns no rows.- Captcha or source outages can surface as 5xx or
Endpoint_out_of_service-style errors depending on handling. - Treat responses as sensitive personal data; comply with Colombian health-privacy rules.