Ciudadano Colombiano con Datos Extendidos

Endpoint

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

Accede a información detallada sobre un ciudadano colombiano usando su identificación gubernamental (Cédula de Ciudadanía). Este endpoint de API proporciona detalles principales—nombre completo, primer nombre, apellido y número de identificación—junto con datos privados extendidos, incluyendo fecha de nacimiento, género y estado de vida, para verificación de identidad mejorada.

Caso de Uso Clave

Diseñado para empresas que requieren verificaciones de identidad profundas para procesos KYC avanzados, detección de fraude o cumplimiento en Colombia. Usar responsablemente debido a la naturaleza sensible de los datos devueltos.

Nota: Este endpoint es exclusivo para documentos de identificación colombianos (Cédula de Ciudadanía). Para otros países o tipos de documentos, por favor consulta nuestros servicios de validación alternativos.

Headers

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

Parámetros de Consulta

Name	Type	Required	Description	Example
documentType	String	True	Tipo de documento. Parámetro válido: CC.	CC
documentNumber	String	True	Número de documento de la persona a consultar, sin espacios o puntos.	123456789
date	String	True	Fecha de emisión del documento. Formato válido: DD/MM/YYYY.	10/10/2020

Solicitud

JavaScript

import axios from 'axios';

const options = {
  method: 'GET',
  url: 'https://api.verifik.co/v2/co/cedula/extra',
  params: {documentType: 'CC', documentNumber: '123456789', date: '10/10/2020'},
  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")
payload = ''
headers = {}
conn.request("GET", "/v2/co/cedula/extra?documentType=CC&documentNumber=123456789&date=10/10/2020", 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/extra?documentType=CC&documentNumber=123456789&date=10%2F10%2F2020")!,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/extra?documentType=CC&documentNumber=123456789&date=10/10/2020');
$request->setMethod(HTTP_Request2::METHOD_GET);
$request->setConfig(array(
  'follow_redirects' => TRUE
));
$request->setBody('');
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();
}
?>

Respuesta

200

{
  "data": {
    "documentType": "CC",
    "documentNumber": "123456789",
    "fullName": "MATEO VERIFIK",
    "firstName": "MATEO",
    "lastName": "VERIFIK",
    "arrayName": [
      "MATEO",
      "VERIFIK"
    ],
    "expeditionDate": "2022-05-10T00:00:00.000Z",
    "expeditionPlace": {
      "municipio": "BOGOTA D.C.",
      "departamento": "BOGOTA"
    },
    "dateOfBirth": "1999-05-07T00:00:00.000Z",
    "gender": "HOMBRE",
    "isAlive": true
  },
  "signature": {
    "dateTime": "August 23, 2022 11:42 AM",
    "message": "Certified by Verifik.co"
  }
}

404

{
    "code": "NotFound",
    "message": "Record not found."
}

409 - Parámetros Faltantes

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

409 - Tipo de Documento Inválido

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

409 - Formato de Fecha Inválido

{
    "code": "MissingParameter",
    "message": "date format required: DD/MM/YYYY\n"
}

Notas

• Este endpoint requiere la fecha de emisión del documento (parámetro date) en formato DD/MM/YYYY
• Solo se soporta el tipo de documento CC (Cédula de Ciudadanía)
• Devuelve información personal sensible incluyendo fecha de nacimiento, género y estado de vida
• Usar responsablemente y asegurar cumplimiento con regulaciones de protección de datos