Colombia — Consulta de ciudadano vía Procuraduría

Valida un número de documento colombiano y extrae nombres de la Procuraduría General de la Nación. Esta fuente oficial soporta Cédula de ciudadanía (CC), Cédula de extranjería (CE), Permiso Especial de Permanencia (PEP), NIT y Permiso por Protección Temporal (PPT).

A diferencia de ciudadano por documento (/v2/co/cedula), este endpoint usa solo Procuraduría — no intenta DIAN, ADRES ni Registraduría. A diferencia de antecedentes disciplinarios (/v2/co/procuraduria/antecedentes), no devuelve antecedentes ni legend.

Qué devuelve esta API

• documentNumber, documentType
• firstName, lastName, fullName, arrayName
• Respuesta Verifik firmada

Referencia API

Endpoint

GET https://api.verifik.co/v2/co/procuraduria

Usa este endpoint cuando necesitas solo extracción de nombres desde Procuraduría, incluidos tipos de documento que otras fuentes de /cedula no cubren. La misma integración está disponible como POST con cuerpo JSON. GET usa parámetros de consulta.

Campos típicos: documentType, documentNumber, firstName, lastName, fullName, arrayName. Usa /v2/co/cedula cuando quieras que Verifik intente varias fuentes oficiales. Usa /v2/co/procuraduria/antecedentes cuando necesites historial disciplinario.

Headers

Name	Value
Accept	application/json
Authorization	Bearer <token>

Parameters

name	type	required	description	Examples
documentType	string	yes	Uno de CC, CE, PPT, NIT, PEP	CE
documentNumber	string	yes	Número de documento, solo dígitos	688925

Request

JavaScript

import axios from "axios";

const { data } = await axios.get("https://api.verifik.co/v2/co/procuraduria", {
	params: {
		documentType: "CE",
		documentNumber: "688925",
	},
	headers: {
		Accept: "application/json",
		Authorization: `Bearer ${process.env.VERIFIK_TOKEN}`,
	},
});
console.log(data);

Python

import os, requests

url = "https://api.verifik.co/v2/co/procuraduria"
headers = {"Accept": "application/json", "Authorization": f"Bearer {os.getenv('VERIFIK_TOKEN')}"}
params = {"documentType": "CE", "documentNumber": "688925"}
r = requests.get(url, headers=headers, params=params)
print(r.json())

Response

200

{
	"data": {
		"documentType": "CE",
		"documentNumber": "688925",
		"firstName": "JUAN SEBASTIAN",
		"lastName": "RAIGOSA GALLEGO",
		"fullName": "JUAN SEBASTIAN RAIGOSA GALLEGO",
		"arrayName": ["JUAN", "SEBASTIAN", "RAIGOSA", "GALLEGO"]
	},
	"signature": {
		"dateTime": "August 25, 2026 12:00 PM",
		"message": "Certified by Verifik.co"
	}
}

404

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

409

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

Características

• Consulta de nombres directa en Procuraduría
• Soporta CC, CE, PPT, NIT, PEP
• Sin antecedentes disciplinarios (antecedentes, legend)
• GET y POST comparten el mismo handler

Casos de uso

• Validar una cédula de extranjería o un NIT cuando solo necesitas el nombre registrado
• Aislar Procuraduría de la consolidación multi-fuente de /cedula
• Preferir un producto dedicado cuando no quieres facturar antecedentes por separado

Notes

• Solo extracción de nombres — la respuesta no incluye antecedentes ni legend.
• Para antecedentes disciplinarios usa antecedentes en Colombia.
• /v2/co/cedula sigue consolidando Procuraduría con otras fuentes para los mismos tipos de documento.
• El documento sandbox reservado 90040401 devuelve 404.
• Relacionado: Ciudadano por documento, Guía de documentos.