Antecedentes na Polícia Nacional da Colômbia

Referência da API

Endpoint

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

O serviço de consulta de antecedentes na Polícia Nacional da Colômbia verifica se uma pessoa tem assuntos pendentes com as autoridades judiciais colombianas, conforme o artigo 248 da Constituição. Envie documentType e documentNumber por GET (query) ou POST (corpo JSON). Um data bem-sucedido inclui documentType, documentNumber, firstName, lastName, fullName, arrayName e details. Ideal para contratação, onboarding e diligência prévia.

Cabeçalhos (Headers)

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

Parâmetros

info

Para a lista completa de tipos de documento suportados e seus parâmetros obrigatórios específicos, consulte o guia Tipos de documento.

Nome	Tipo	Obrigatório	Descrição
documentType	string	Sim	Tipo de documento. Valores válidos: CC, CE, PPT, PA, DP. DP é Documento Diplomático. PPT é aceito; o portal da Policía o trata como passaporte.
documentNumber	string	Sim	Número do documento da pessoa a ser consultada, sem espaços ou pontos.

Este endpoint não recebe o parâmetro date (diferente do RNMC).

Requisição (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 <seu_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/policia/consultar?documentType=CC&documentNumber=1032386359", 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/policia/consultar?documentType=CC&documentNumber=1032386359")!,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/policia/consultar?documentType=CC&documentNumber=1032386359');
$request->setMethod(HTTP_Request2::METHOD_GET);
$request->setConfig(array(
  'follow_redirects' => TRUE
));
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();
}

Resposta (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 ausentes)

{
  "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 (Origem indisponível)

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

Observações (Notes)

• GET e POST são suportados. O POST envia os mesmos campos no corpo JSON.
• O portal da Policía imprime apellidos e depois nombres. A Verifik devolve primeiro os prenomes: firstName LILIA MANUELA, lastName LESPORT FERNANDEZ, fullName LILIA MANUELA LESPORT FERNANDEZ e arrayName com prenomes e depois sobrenomes.
• Em produção, data.details é apenas a frase NO TIENE / REGISTRA ASUNTOS. A legenda constitucional é removida.
• O sandbox pode incluir também legend. Não trate legend como campo garantido em produção.
• Os documentType permitidos são CC, CE, PPT, PA e DP (Documento Diplomático). PPT é aceito; o portal o trata como passaporte.
• Esta rota não exige date de expedição (o RNMC exige).
• Falhas temporárias da origem ou do captcha retornam 409 com Endpoint_out_of_service ou captcha_failed.
• Para medidas corretivas pendentes, use Colômbia - RNMC / medidas corretivas (GET /v2/co/policia/rnmc).