🇨🇴Colombian RETHUS Verification Data

Service to consult healthcare professionals, validating them using RETHUS (National Unique Registry of Human Talent in Health).

Colombian RETHUS Verification Data

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

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.

Implementation

Headers

Name	Value
Content-Type	application/json
Authorization	Bearer <token>

Query 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

Request

JavaScript

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);
}

Python

import http.client

conn = http.client.HTTPSConnection("api.verifik.co")
payload = ''
headers = {}
conn.request("GET", "/v2/co/cedula/rethus?documentType=CC&documentNumber=123456789", payload, headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))

Swift

var request = URLRequest(url: URL(string: "https://api.verifik.co/v2/co/cedula/rethus?documentType=CC&documentNumber=123456789")!,timeoutInterval: Double.infinity)
request.httpMethod = "GET"

let task = URLSession.shared.dataTask(with: request) { data, response, error in 
  guard let data = data else {
    print(String(describing: error))
    return
  }
  print(String(data: data, encoding: .utf8)!)
}

task.resume()

PHP

<?php
require_once 'HTTP/Request2.php';
$request = new HTTP_Request2();
$request->setUrl('https://api.verifik.co/v2/co/cedula/rethus?documentType=CC&documentNumber=123456789');
$request->setMethod(HTTP_Request2::METHOD_GET);
$request->setConfig(array(
  'follow_redirects' => TRUE
));
try {
  $response = $request->send();
  if ($response->getStatus() == 200) {
    echo $response->getBody();
  }
  else {
    echo 'Unexpected HTTP status: ' . $response->getStatus() . ' ' .
    $response->getReasonPhrase();
  }
}
catch(HTTP_Request2_Exception $e) {
  echo 'Error: ' . $e->getMessage();
}

Response

200

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

404

{
"code": "NotFound",
"message": "Record not found.",
"signature": {
"dateTime": "August 31, 2022 3:24 PM",
"message": "Certified by Verifik.co"
}
}

409

{
"code": "MissingParameter",
"message": "missing documentType\n. missing documentNumber\n"
}

409

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