Salud

Datos de Verificación RETHUS Colombiano

Endpoint

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

Este servicio permite verificar la autenticidad de una cédula colombiana y acceder a información del Registro Único Nacional de Talento Humano en Salud (RETHUS). Al proporcionar el tipo y número de documento, puedes recuperar detalles como el nombre completo del individuo, estado RETHUS, y sus datos académicos y de Seguridad Social. Los datos RETHUS incluyen información sobre los títulos académicos del profesional de la salud y afiliación a Seguridad Social, incluyendo beneficios y modalidades.

Headers

Nombre	Valor
Content-Type	application/json
Authorization	Bearer <token>

Parámetros

Nombre	Tipo	Requerido	Descripción
documentType	string	Sí	Tipo de documento. Parámetro válido: CC.
documentNumber	string	Sí	Número de documento de la persona a consultar, sin espacios ni puntos.

Solicitud

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: 'Bearer <tu_token>'
  }
};

try {
  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")

headers = {
    'Accept': "application/json",
    'Authorization': "Bearer <token>"
}

conn.request("GET", "/v2/co/cedula/rethus?documentType=CC&documentNumber=123456789", headers=headers)

res = conn.getresponse()
data = res.read()

print(data.decode("utf-8"))

Swift

import Foundation

let headers = [
  "Accept": "application/json",
  "Authorization": "Bearer <token>"
]

let request = NSMutableURLRequest(url: NSURL(string: "https://api.verifik.co/v2/co/cedula/rethus?documentType=CC&documentNumber=123456789")! as URL,
                                        cachePolicy: .useProtocolCachePolicy,
                                    timeoutInterval: 10.0)
request.httpMethod = "GET"
request.allHTTPHeaderFields = headers

let session = URLSession.shared
let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in
  if (error != nil) {
    print(error as Any)
  } else {
    let httpResponse = response as? HTTPURLResponse
    print(httpResponse)
  }
})

dataTask.resume()

PHP

<?php

$client = new \GuzzleHttp\Client();

$response = $client->request('GET', 'https://api.verifik.co/v2/co/cedula/rethus?documentType=CC&documentNumber=123456789', [
  'headers' => [
    'Accept' => 'application/json',
    'Authorization' => 'Bearer <token>',
  ],
]);

echo $response->getBody();

Respuesta

200

{
  "success": true,
  "data": {
    "documentType": "CC",
    "documentNumber": "123456789",
    "firstName": "Carlos",
    "lastName": "Mendoza",
    "fullName": "Carlos Mendoza",
    "rethusStatus": "active",
    "academicDegrees": [
      {
        "degree": "Médico General",
        "institution": "Universidad Nacional",
        "year": "2015"
      }
    ],
    "socialSecurityAffiliation": {
      "status": "active",
      "benefits": "Completo",
      "modality": "Contributivo"
    },
    "specialization": "Medicina General",
    "licenseNumber": "12345"
  }
}

404

{
  "success": false,
  "error": "Profesional de la salud no encontrado",
  "code": "HEALTH_PROFESSIONAL_NOT_FOUND"
}

409

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

Características

• Verificación de Credenciales de Salud: Verificar credenciales de profesionales de la salud
• Licencias Médicas: Confirmar licencias médicas y especializaciones
• Verificación de Seguros: Verificar afiliaciones de seguros de salud
• Cumplimiento Regulatorio: Cumplir con requisitos regulatorios de salud
• Seguridad del Paciente: Asegurar proveedores de salud calificados
• Respuesta Estructurada: Formato de datos organizado para fácil integración
• Múltiples Lenguajes de Programación: Soporte para JavaScript, Python, PHP y Swift
• Manejo de Errores: Respuestas de error comprensivas para varios escenarios

Casos de Uso

• Verificación de Salud: Verificar credenciales de profesionales de la salud
• Licencias Médicas: Confirmar licencias médicas y especializaciones
• Verificación de Seguros: Verificar afiliaciones de seguros de salud
• Cumplimiento Regulatorio: Cumplir con requisitos regulatorios de salud
• Seguridad del Paciente: Asegurar proveedores de salud calificados