Colombia — Registraduría ID validity certificate (CC)

This endpoint returns the certificate of validity (certificado de vigencia) for a Colombian Cédula de Ciudadanía (CC) from Registraduría Nacional del Estado Civil, using the document number and issue date. The response includes structured fields parsed from the official PDF (including a base64-encoded PDF) and status information such as novedad (validity state from the preliminary check).

The underlying flow targets CC holders; the API validates documentNumber and date only.

What this API returns

• Validity status context (novedad) from the upstream vigencia check
• Structured document fields (e.g. number, issue date, issue place, name) when parsing succeeds
• Verification code and PDF (pdfBase64) for audit and downstream use
• A signed Verifik response wrapper

API reference

Endpoint

GET https://api.verifik.co/v2/co/registraduria/certificado

The same integration is available as POST with a JSON body containing the same fields. GET uses query parameters as shown below.

Headers

Name	Value
Accept	application/json
Authorization	Bearer <token>

Parameters

name	type	required	description
documentNumber	string	yes	CC number without spaces or punctuation.
date	string	yes	Issue date of the document in DD/MM/YYYY.

Request

JavaScript

import axios from "axios";

const { data } = await axios.get("https://api.verifik.co/v2/co/registraduria/certificado", {
	params: {
		documentNumber: "123456789",
		date: "10/10/2020",
	},
	headers: {
		Accept: "application/json",
		Authorization: `Bearer ${process.env.VERIFIK_TOKEN}`,
	},
});
console.log(data);

Python

import os, requests

url = "https://api.verifik.co/v2/co/registraduria/certificado"
headers = {"Accept": "application/json", "Authorization": f"Bearer {os.getenv('VERIFIK_TOKEN')}"}
params = {"documentNumber": "123456789", "date": "10/10/2020"}
r = requests.get(url, headers=headers, params=params)
print(r.json())

Response

200

{
	"data": {
		"codigoVerificacion": "ABC123XYZ",
		"novedad": "VIGENTE",
		"pdfBase64": "JVBERi0xLjQK...",
		"documento": {
			"cedula": "123456789",
			"fechaExpedicion": "10/10/2020",
			"lugarExpedicion": "BOGOTA D.C.",
			"nombre": "JUAN PEREZ"
		}
	},
	"signature": {
		"dateTime": "August 23, 2022 11:42 AM",
		"message": "Certified by Verifik.co"
	}
}

404

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

409

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

Features

• Issue date must match DD/MM/YYYY
• PDF-backed certificate data with base64 payload when generation succeeds
• GET and POST share the same handler

Use cases

• KYC checks that require an official validity certificate for a Colombian CC
• Fraud reduction when the issue date is known and must match Registraduría records

Notes

• date is the document issue date, not the date of birth.
• Wrong DD/MM/YYYY format typically returns 409 (MissingParameter).
• Upstream or scraping failures (e.g. captcha/PDF flow) may surface as 409 with codes such as Endpoint_out_of_service.
• GET and POST share the same handler; use POST if you prefer a JSON body.
• Treat pdfBase64 and personal fields as sensitive; comply with Colombian privacy rules and your contracts.