哥伦比亚 — INPEC 在押人员核查

API 参考

Endpoint

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

INPEC 在押人员核查服务可用于核实当前在哥伦比亚国家监狱与司法机构（INPEC）所辖监所中的羁押状态。该接口可判断某人当前是否在 INPEC 管理的羁押场所中被剥夺自由，并提供其法律状态、入所类型、所在监狱、以及在监狱系统内的唯一识别编号等详细信息。

本服务面向司法机关、执法部门、国家监督机构及具备授权资质的组织，用于在司法、安全或尽职调查目的下核实人员在哥伦比亚监狱系统中的当前状态。

请求头（Headers）

名称	取值
Content-Type	`application/json`
Authorization	`Bearer <token>`

参数（Parameters）

info

有关支持的证件类型及其专属必填参数的完整清单,请参阅证件类型指南。

名称	类型	必填	描述
`documentType`	string	是	证件类型。允许取值：CC、CE。
`documentNumber`	string	是	待查询人员的证件号码,不含空格或圆点。
`firstSurname`	string	是	待查询人员的第一姓氏。

请求（Request）

JavaScript
Python
Swift
PHP

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 <your_token>'
  }
};

try {
  const { data } = await axios.request(options);
  console.log(data);
} catch (error) {
  console.error(error);
}

import http.client

conn = http.client.HTTPSConnection("api.verifik.co")

headers = {
    'Accept': "application/json",
    'Authorization': "Bearer <your_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"))

import Foundation

let headers = [
  "Accept": "application/json",
  "Authorization": "Bearer <your_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

$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 <your_token>',
  ],
]);

echo $response->getBody();

响应（Response）

200 - 找到记录
200 - 无记录
404
409（缺少参数）
409（无效的证件类型）

{
  "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"
}

{
  "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"
}

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

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

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

响应字段

Data 对象

字段	类型	描述
`documentNumber`	string	被查询人员的证件号码
`documentType`	string	证件类型（CC 或 CE）
`firstSurname`	string	被查询人员的第一姓氏
`legend`	string	表示是否找到记录的说明文本
`records`	array	监狱记录数组（无记录时为空数组）

Records 对象（找到记录时）

字段	类型	描述
`admissionStatus`	string	入所状态（例如 "INTRAMURAL" 表示在所内羁押）
`gender`	string	在押人员性别（MASCULINO/FEMENINO）
`identification`	string	身份证件号码
`legalStatus`	string	法律状态（例如 "CONDENADO" 已被判决,"SINDICADO" 被指控）
`name`	string	在押人员的姓名全称
`prison`	string	羁押所在的监狱或监管联合体名称
`uniqueNumber`	string	在 INPEC 系统内的唯一识别编号

功能特性

实时在押状态：实时查询 INPEC 管辖设施中的羁押状态。
完整信息返回：返回法律状态、入所类型、性别及监狱位置等。
合法合规：来自 INPEC 的官方数据,适用于司法与安全场景。
结构化响应：数据格式整齐,便于集成。
多语言支持：兼容 JavaScript、Python、PHP 与 Swift。
错误处理：覆盖多种场景的完善错误响应。

使用场景

背景调查：核验某人当前是否存在羁押记录。
法律尽调：在司法程序中确认其法律状态。
安全筛查：用于雇佣或安全许可的资格审核。
亲属确认：协助家属确认羁押状态。
合规审查：满足敏感岗位的合规审查要求。

API 参考​

Endpoint​

请求头（Headers）​

参数（Parameters）​

请求（Request）​

响应（Response）​

响应字段​

Data 对象​

Records 对象（找到记录时）​

功能特性​

使用场景​