Colômbia - Verificação de Antecedentes Penitenciários (INPEC)

Referência da API

Endpoint

https://api.verifik.co/v2/co/inpec

O serviço de Verificação de Antecedentes Penitenciários do INPEC permite verificar o status atual de encarceramento de pessoas em estabelecimentos administrados pelo Instituto Nacional Penitenciário e Carcerário da Colômbia (INPEC). Este endpoint da API valida se uma pessoa está atualmente privada de liberdade em algum centro de detenção administrado pelo INPEC e fornece informações detalhadas sobre seu status legal, tipo de admissão, localização da prisão e número único de identificação dentro do sistema penitenciário.

Este serviço é projetado para autoridades judiciais, órgãos de aplicação da lei, órgãos de controle estatal e organizações autorizadas que precisam verificar o status atual de pessoas dentro do sistema penitenciário colombiano para fins legais, de segurança ou de due diligence.

Cabeçalhos

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. Parâmetros válidos: CC, CE.
documentNumber	string	Sim	Número do documento da pessoa a ser consultada, sem espaços ou pontos.
firstSurname	string	Sim	Primeiro sobrenome da pessoa a ser consultada.

Requisição

JavaScript

import axios from 'axios';

const options = {
  method: 'GET',
  url: 'https://api.verifik.co/v2/co/inpec',
  params: {
    documentType: 'CC',
    documentNumber: '80086615',
    firstSurname: 'MURCIA'
  },
  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")

headers = {
    'Accept': "application/json",
    'Authorization': "Bearer <seu_token>"
}

conn.request("GET", "/v2/co/inpec?documentType=CC&documentNumber=80086615&firstSurname=MURCIA", headers=headers)

res = conn.getresponse()
data = res.read()

print(data.decode("utf-8"))

Swift

import Foundation

let headers = [
  "Accept": "application/json",
  "Authorization": "Bearer <seu_token>"
]

let request = NSMutableURLRequest(url: NSURL(string: "https://api.verifik.co/v2/co/inpec?documentType=CC&documentNumber=80086615&firstSurname=MURCIA")! 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/inpec?documentType=CC&documentNumber=80086615&firstSurname=MURCIA', [
  'headers' => [
    'Accept' => 'application/json',
    'Authorization' => 'Bearer <seu_token>',
  ],
]);

echo $response->getBody();

Resposta

200 - Registro encontrado

{
  "data": {
    "documentNumber": "80086615",
    "documentType": "CC",
    "firstSurname": "MURCIA",
    "legend": "Se encontró un registro de Persona privada de la libertad con los siguientes datos",
    "records": [
      {
        "admissionStatus": "INTRAMURAL",
        "gender": "MASCULINO",
        "identification": "80086615",
        "legalStatus": "CONDENADO",
        "name": "DAVID EDUARDO HELMUT MURCIA GUZMAN",
        "prison": "COMPLEJO CARCELARIO Y PENITENCIARIO BOGOTA",
        "uniqueNumber": "277351"
      }
    ]
  },
  "signature": {
    "dateTime": "October 27, 2025 12:53 PM",
    "message": "Certified by Verifik.co"
  },
  "id": "YKOR5"
}

200 - Sem registros

{
  "data": {
    "documentNumber": "123456789",
    "documentType": "CC",
    "firstSurname": "EXAMPLE",
    "legend": "No se encontraron registros de Persona privada de la libertad",
    "records": []
  },
  "signature": {
    "dateTime": "October 27, 2025 12:53 PM",
    "message": "Certified by Verifik.co"
  },
  "id": "ABC12"
}

404

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

409 (Parâmetros ausentes)

{
  "code": "MissingParameter",
  "message": "missing documentType\n. missing documentNumber\n. missing firstSurname\n"
}

409 (Tipo de documento inválido)

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

Campos da resposta

Objeto Data

Campo	Tipo	Descrição
documentNumber	string	Número do documento da pessoa consultada
documentType	string	Tipo do documento (CC ou CE)
firstSurname	string	Primeiro sobrenome da pessoa consultada
legend	string	Mensagem indicando se foram encontrados registros
records	array	Lista de registros prisionais (vazia se não houver)

Objeto Records (quando encontrado)

Campo	Tipo	Descrição
admissionStatus	string	Status de admissão (ex.: "INTRAMURAL" para presos internados na unidade)
gender	string	Gênero do detento (MASCULINO/FEMENINO)
identification	string	Número de identificação
legalStatus	string	Status legal (ex.: "CONDENADO" para condenado, "SINDICADO" para acusado)
name	string	Nome completo do detento
prison	string	Nome da prisão ou complexo penitenciário onde a pessoa está detida
uniqueNumber	string	Número único de identificação dentro do sistema INPEC

Recursos

• Status prisional em tempo real: consulta o status atual de encarceramento em unidades do INPEC.
• Informações abrangentes: retorna status legal, tipo de admissão, gênero e localização da prisão.
• Conformidade legal: dados oficiais do INPEC para fins judiciais e de segurança.
• Resposta estruturada: formato de dados organizado para fácil integração.
• Múltiplas linguagens de programação: suporte para JavaScript, Python, PHP e Swift.
• Tratamento de erros: respostas de erro abrangentes para diversos cenários.

Casos de uso

• Verificações de antecedentes: confirmar se uma pessoa possui registros atuais de encarceramento.
• Due diligence jurídica: confirmar status legal para procedimentos judiciais.
• Triagem de segurança: validar informações para emprego ou autorizações de segurança.
• Verificação familiar: permitir que parentes confirmem o status de detenção.
• Verificação de conformidade: garantir conformidade regulatória para cargos sensíveis.