Colombia - Consulta INPEC Población Privada de la Libertad

Endpoint

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

El servicio de Consulta de la Población Privada de la Libertad INPEC permite verificar el estado actual de privación de libertad de personas en establecimientos administrados por el Instituto Nacional Penitenciario y Carcelario (INPEC) de Colombia. Este endpoint de API valida si una persona se encuentra actualmente privada de la libertad en cualquier centro de detención administrado por INPEC y proporciona información detallada sobre su estado legal, tipo de admisión, ubicación penitenciaria y número único de identificación dentro del sistema carcelario.

Este servicio está diseñado para autoridades judiciales, organismos de seguridad del estado, organismos de control y organizaciones autorizadas que necesitan verificar el estado actual de individuos dentro del sistema penitenciario colombiano con fines legales, de seguridad o de debida diligencia.

Headers

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

Parámetros

Nombre	Tipo	Requerido	Descripción
documentType	string	Sí	Tipo de documento. Parámetros válidos: CC, CE.
documentNumber	string	Sí	Número de documento de la persona a consultar, sin espacios ni puntos.
firstSurname	string	Sí	Primer apellido de la persona a consultar.

Request

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 <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 <tu_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 <tu_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 <tu_token>',
  ],
]);

echo $response->getBody();

Response

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 - Sin Registros

{
  "data": {
    "documentNumber": "123456789",
    "documentType": "CC",
    "firstSurname": "EJEMPLO",
    "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 Faltantes)

{
  "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 de Respuesta

Objeto Data

Campo	Tipo	Descripción
documentNumber	string	Número de documento de la persona consultada
documentType	string	Tipo de documento (CC o CE)
firstSurname	string	Primer apellido de la persona consultada
legend	string	Mensaje indicando si se encontraron registros
records	array	Array de registros carcelarios (vacío si no hay)

Objeto Records (cuando se encuentra)

Campo	Tipo	Descripción
admissionStatus	string	Estado de admisión (ej: "INTRAMURAL" para internos dentro del establecimiento)
gender	string	Género del interno (MASCULINO/FEMENINO)
identification	string	Número de identificación
legalStatus	string	Estado legal (ej: "CONDENADO" para condenado, "SINDICADO" para sindicado)
name	string	Nombre completo del interno
prison	string	Nombre de la cárcel o complejo penitenciario donde se encuentra detenida la persona
uniqueNumber	string	Número único de identificación dentro del sistema INPEC

Características

• Estado Carcelario en Tiempo Real: Consulte el estado actual de privación de la libertad en establecimientos INPEC
• Información Completa: Retorna estado legal, tipo de admisión, género y ubicación penitenciaria
• Cumplimiento Legal: Datos oficiales del INPEC para fines judiciales y de seguridad
• Respuesta Estructurada: Formato de datos organizado para fácil integración
• Múltiples Lenguajes de Programación: Soporte para JavaScript, Python, PHP y Swift
• Manejo de Errores: Respuestas de error completas para varios escenarios

Casos de Uso

• Verificación de Antecedentes: Verificar si un individuo tiene registros de privación de la libertad actuales
• Debida Diligencia Legal: Confirmar estado legal para procedimientos judiciales
• Filtrado de Seguridad: Validar información para contratación o autorizaciones de seguridad
• Verificación Familiar: Permitir a familiares confirmar el estado de detención
• Verificación de Cumplimiento: Asegurar cumplimiento regulatorio para posiciones sensibles