This service allows you to verify the authenticity of a Colombian ID (Cédula) and access information from the National Unique Registry of Human Talent in Health (RETHUS). By providing the document type and number, you can retrieve details such as the individual's full name, RETHUS status, and their academic and Social Security data. The RETHUS data includes information about the healthcare professional's academic degrees and Social Security affiliation, including benefits and modalities.
Parameters
Name |
Type |
¿Required? |
Description |
Example |
documentType |
String |
True |
Document type. Valid parameter: CC. |
CC |
documentNumber |
String |
True |
Document number of the person to consult, without spaces or points. |
123456789 |
Implementation
Request
import axios from 'axios';
const options = {
method: 'GET',
url: '<https://api.verifik.co/v2/co/cedula/rethus>',
params: {documentType: 'CC', documentNumber: '123456789'},
headers: {
Accept: 'application/json',
Authorization: 'jwt <tu_token>'
}
};
try {
notFou const { data } = await axios.request(options);
console.log(data);
} catch (error) {
console.error(error);
}
Response 200 - (Successful response)
{
"data": {
"documentType": "CC",
"documentNumber": "123456789",
"fullName": "MATEO VERIFIK",
"firstName": "MATEO",
"lastName": "VERIFIK",
"arrayName": [
"MATEO",
"VERIFIK"
],
"rethus": {
"status": "Vigente",
"academic": [
{
"type": "UNV",
"originDegree": "Local",
"profession": "MEDICINA",
"startDate": "2021-02-01",
"administrativeAct": "12345",
"entity": "COLEGIO MEDICO COLOMBIANO"
}
],
"dataSSO": [
{
"typeBenefit": "Exonerado del SSO",
"typePlaceBenefit": "Local",
"placeBenefit": "COLOMBIA|BOGOTÁ, D.C.|BOGOTÁ, D.C.",
"startDate": "1900-01-01",
"endDate": "1900-01-01",
"modalityBenefit": "Sin Modalidad",
"programBenefit": "Medicina",
"entity": "COLEGIO MEDICO COLOMBIANO"
}
]
}
},
"signature": {
"dateTime": "August 23, 2022 10:14 AM",
"message": "Certified by Verifik.co"
}
}
Other responses
|
Code |
Description |
Response Body |
404 |
Not Found |
Information not found. |
{ |
"code": "NotFound", |
|
|
|
"message": "Record not found.", |
|
|
|
"signature": { |
|
|
|
"dateTime": "August 31, 2022 3:24 PM", |
|
|
|
"message": "Certified by Verifik.co" |
|
|
|
} |
|
|
|
} |
|
|
|
409 |
Conflict |
Some parameters are missing. |
{ |
"code": "MissingParameter", |
|
|
|
"message": "missing documentType\n. missing documentNumber\n" |
|
|
|
} |
|
|
|
409 |
Conflict |
Invalid documentType for this request. |
{ |
"code": "MissingParameter", |
|
|
|
"message": "documentType must be one of: [CC]" |
|
|
|
} |
|
|
|