🇨🇴Certificado de Registro

Servicio para generar un certificado de validez de documentos a través de la Oficina de Registro.

Endpoint

https://api.verifik.co/v2/co/registraduría/certificado

El servicio de Certificado de Registro proporciona un método programático para verificar la validez de un documento de identidad colombiano y obtener el estado del certificado. Al utilizar el número de documento y la fecha para consultar la base de datos de la Registraduría Nacional del Estado Civil, este servicio devuelve una respuesta en formato JSON con el estado del certificado, cualquier notificación o excepción, y un PDF del certificado codificado en base64.

Este servicio es ideal para instituciones, empresas o personas en Colombia que necesiten verificar la autenticidad de un documento de identidad colombiano o de un certificado.

Headers

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

Parameters

Name	Type	Required?	Description	Example
documentNumber	String	True	Document number of the person to consult, without spaces or points.	123456789
date	String	True	Date of issuance of the cedula to consult. Valid format: DD/MM/YYYY.	10/10/2020

Request

JavaScript

import axios from 'axios';

const options = {
  method: 'GET',
  url: 'https://api.verifik.co/v2/co/registraduria/certificado',
  params: {documentNumber: '901331380', date: '10/10/2020'},
  headers: {
    Accept: 'application/json',
    Authorization: 'jwt <tu_token>'
  }
};

try {
  const { data } = await axios.request(options);
  console.log(data);
} catch (error) {
  console.error(error);
}

Python

import requests

options = {
    'method': 'GET',
    'url': 'https://api.verifik.co/v2/co/registraduria/certificado',
    'params': {'documentNumber': '901331380', 'date': '10/10/2020'},
    'headers': {
        'Accept': 'application/json',
        'Authorization': 'jwt <tu_token>'
    }
}

try:
    response = requests.request(options['method'], options['url'], headers=options['headers'], params=options['params'])
    data = response.json()
    print(data)
except Exception as error:
    print(error)

Swift

import Foundation

let url = URL(string: "https://api.verifik.co/v2/co/registraduria/certificado")!
var request = URLRequest(url: url)
request.httpMethod = "GET"
request.setValue("application/json", forHTTPHeaderField: "Accept")
request.setValue("jwt <tu_token>", forHTTPHeaderField: "Authorization")

let queryItems = [
    URLQueryItem(name: "documentNumber", value: "901331380"),
    URLQueryItem(name: "date", value: "10/10/2020")
]
var urlComponents = URLComponents(url: url, resolvingAgainstBaseURL: false)!
urlComponents.queryItems = queryItems
request.url = urlComponents.url

let task = URLSession.shared.dataTask(with: request) { data, response, error in
    if let error = error {
        print(error)
        return
    }
    
    guard let data = data else { return }
    
    do {
        let jsonData = try JSONSerialization.jsonObject(with: data, options: [])
        print(jsonData)
    } catch {
        print(error)
    }
}

task.resume()

PHP

<?php

$options = [
    'http' => [
        'header' => [
            "Accept: application/json",
            "Authorization: jwt <tu_token>"
        ],
        'method' => 'GET',
    ]
];

$context = stream_context_create($options);
$url = 'https://api.verifik.co/v2/co/registraduria/certificado?documentNumber=901331380&date=10/10/2020';

try {
    $data = file_get_contents($url, false, $context);
    echo $data;
} catch (Exception $error) {
    echo $error->getMessage();
}

?>

Response

200

{
    "data": {
        "codigoVerificacion": "2143291740",
        "novedad": "VIGENTE (VIVO)",
        "pdfBase64": "JVBERi0xLjQKJeLjz9+miUACiiigD...NoY3CiUlRU9GCg==",
        "documento": {
            "cedula": "1.121.329.661",
            "fechaExpedicion": "16 DE JULIO DE 2007",
            "lugarExpedicion": "VILLANUEVA - LA GUAJIRA",
            "nombre": "ANUAR DE JESUS HERNANDEZ GARCIA"
        }
    },
    "signature": {
        "dateTime": "August 29, 2024 10:39 PM",
        "message": "Certified by Verifik.co"
    },
    "id": "7KTH7"
}

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": "date format required: DD/MM/YYYY\n"}
}