Colombia - Verificación de Antecedentes Policiales

Referencia de API

Endpoint

https://api.verifik.co/v2/co/policia/consultar

El servicio de Verificación de Antecedentes Policiales de Colombia permite verificar si una persona tiene asuntos pendientes con las autoridades judiciales colombianas, de conformidad con el Artículo 248 de la Constitución. Envíe documentType y documentNumber por GET (query) o POST (cuerpo JSON). Un data exitoso incluye documentType, documentNumber, firstName, lastName, fullName, arrayName y details. Es ideal para contratación, onboarding y debida diligencia.

Headers

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

Parámetros

info

Para consultar la lista completa de Tipos de Documento soportados y sus parámetros obligatorios específicos, visita la guía de Tipos de Documento.

Nombre	Tipo	Requerido	Descripción
documentType	string	Sí	Tipo de documento. Valores válidos: CC, CE, PPT, PA, DP. DP es Documento Diplomático. PPT se acepta; el portal de la Policía lo trata como un pasaporte.
documentNumber	string	Sí	Número de documento de la persona a consultar, sin espacios ni puntos.

Este endpoint no recibe el parámetro date (a diferencia de RNMC).

Request

JavaScript

import axios from 'axios';

const options = {
  method: 'GET',
  url: 'https://api.verifik.co/v2/co/policia/consultar',
  params: {documentType: 'CC', documentNumber: '1032386359'},
  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/policia/consultar?documentType=CC&documentNumber=1032386359", 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/policia/consultar?documentType=CC&documentNumber=1032386359")! 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/policia/consultar?documentType=CC&documentNumber=1032386359', [
  'headers' => [
    'Accept' => 'application/json',
    'Authorization' => 'Bearer token',
  ],
]);

echo $response->getBody();

Response

200

{
  "data": {
    "documentType": "CC",
    "documentNumber": "1032386359",
    "firstName": "LILIA MANUELA",
    "lastName": "LESPORT FERNANDEZ",
    "fullName": "LILIA MANUELA LESPORT FERNANDEZ",
    "arrayName": ["LILIA", "MANUELA", "LESPORT", "FERNANDEZ"],
    "details": "NO TIENE ASUNTOS PENDIENTES CON LAS AUTORIDADES JUDICIALES de conformidad con lo establecido en el artículo 248 de la Constitución Política de Colombia."
  },
  "signature": {
    "dateTime": "March 13, 2024 10:48 PM",
    "message": "Certified by Verifik.co"
  },
  "id": "7QS69"
}

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,CE,PPT,PA,DP]"
}

409 (Origen no disponible)

{
  "code": "Endpoint_out_of_service",
  "message": "Endpoint_out_of_service"
}

Notas

• Se admiten GET y POST. POST envía los mismos campos en el cuerpo JSON.
• El portal de la Policía imprime apellidos y luego nombres. Verifik devuelve primero los nombres de pila: firstName LILIA MANUELA, lastName LESPORT FERNANDEZ, fullName LILIA MANUELA LESPORT FERNANDEZ y arrayName con nombres y luego apellidos.
• En producción, data.details es solo la oración NO TIENE / REGISTRA ASUNTOS. La leyenda constitucional se elimina.
• Cuando el portal de la Policía no puede generar el certificado en línea, la API igual responde 200. data.details es la frase oficial de atención presencial (“El resultado de su consulta no puede ser generado…”). Esa página no es un 404. Los campos de nombre se incluyen solo si Verifik ya los tiene en caché.
• El sandbox puede incluir también legend. No trate legend como un campo garantizado en producción.
• Los documentType permitidos son CC, CE, PPT, PA y DP (Documento Diplomático). PPT se acepta; el portal lo trata como un pasaporte.
• Esta ruta no exige date de expedición (RNMC sí).
• Fallos temporales del origen o del captcha devuelven 409 con Endpoint_out_of_service o captcha_failed.
• Para medidas correctivas pendientes, use Colombia - Cumplimiento Policial (GET /v2/co/policia/rnmc).