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]"
}