Colombie - Vérification INPEC (détention)

Référence de l'API

Endpoint

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

Le service de vérification des dossiers pénitentiaires INPEC permet de vérifier le statut actuel d'incarcération des personnes dans les établissements gérés par l'Instituto Nacional Penitenciario y Carcelario (INPEC) de Colombie. Cet endpoint indique si une personne est actuellement privée de liberté dans un centre de détention administré par l'INPEC et fournit des informations détaillées sur son statut juridique, son type d'admission, l'établissement de détention et son numéro d'identification unique au sein du système pénitentiaire.

Ce service est destiné aux autorités judiciaires, aux forces de l'ordre, aux organes de contrôle de l'État et aux organisations habilitées qui ont besoin de vérifier le statut actuel de personnes détenues dans le système pénitentiaire colombien à des fins légales, sécuritaires ou de diligence raisonnable.

En-têtes (Headers)

Nom	Valeur
Content-Type	application/json
Authorization	Bearer <token>

Paramètres

info

Pour la liste complète des types de documents pris en charge ainsi que de leurs paramètres obligatoires spécifiques, consultez le guide Types de documents.

Nom	Type	Requis	Description
documentType	string	Oui	Type de document. Valeurs autorisées : CC, CE.
documentNumber	string	Oui	Numéro de document de la personne à interroger, sans espaces ni points.
firstSurname	string	Oui	Premier nom de famille de la personne à interroger.

Requête (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 <votre_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 <votre_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 <votre_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 <votre_token>',
  ],
]);

echo $response->getBody();

Réponse (Response)

200 - Dossier trouvé

{
  "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 - Aucun dossier

{
  "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 (Paramètres manquants)

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

409 (Type de document invalide)

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

Champs de la réponse

Objet data

Champ	Type	Description
documentNumber	string	Numéro de document de la personne consultée.
documentType	string	Type de document (CC ou CE).
firstSurname	string	Premier nom de famille de la personne consultée.
legend	string	Message indiquant si des dossiers ont été trouvés.
records	array	Liste des dossiers pénitentiaires (vide si aucun résultat).

Objet records (lorsqu'un dossier existe)

Champ	Type	Description
admissionStatus	string	Statut d'admission (par ex. « INTRAMURAL » pour les détenus à l'intérieur de l'établissement).
gender	string	Sexe du détenu (MASCULINO/FEMENINO).
identification	string	Numéro d'identification.
legalStatus	string	Statut juridique (par ex. « CONDENADO » pour condamné, « SINDICADO » pour mis en cause).
name	string	Nom complet du détenu.
prison	string	Nom de la prison ou du complexe pénitentiaire où la personne est détenue.
uniqueNumber	string	Numéro d'identification unique au sein du système INPEC.

Fonctionnalités

• Statut pénitentiaire en temps réel : interrogez en direct le statut d'incarcération dans les établissements de l'INPEC.
• Informations complètes : statut juridique, type d'admission, sexe et établissement de détention.
• Conformité légale : données officielles de l'INPEC pour les usages judiciaires et sécuritaires.
• Réponse structurée : format de données organisé pour faciliter l'intégration.
• Plusieurs langages de programmation : exemples en JavaScript, Python, PHP et Swift.
• Gestion d'erreurs : réponses d'erreur détaillées pour chaque scénario.

Cas d'usage

• Vérifications d'antécédents : confirmez si une personne est actuellement détenue.
• Diligence raisonnable juridique : validez le statut juridique pour des procédures judiciaires.
• Vérification de sécurité : sécurisez les processus d'embauche ou les habilitations sécuritaires.
• Vérification familiale : permettez aux proches de confirmer un statut de détention.
• Conformité réglementaire : assurez la conformité pour les postes sensibles.