コロンビア — INPEC（収容者照会）

API リファレンス

エンドポイント

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

INPEC（コロンビア国家刑務所・矯正機関）が管理する施設における個人の現在の収容状態を検証するサービスです。本エンドポイントは、対象者が INPEC の管理する拘禁施設に現に身柄を拘束されているかを検証し、法的状態、収容形態、収容施設、刑務システム内の固有識別番号などの詳細情報を提供します。

本サービスは、司法当局、法執行機関、国家統制機関、および法的・安全保障・デューデリジェンス目的でコロンビアの刑務システム内の対象者の現状を確認する必要のある認可機関向けに設計されています。

ヘッダー

名前	値
Content-Type	application/json
Authorization	Bearer <token>

パラメーター

info

対応する 文書タイプ とそれぞれの必須パラメーターの一覧については、文書タイプ ガイドをご参照ください。

名前	型	必須	説明
documentType	string	はい	文書タイプ。許可される値: CC, CE。
documentNumber	string	はい	照会対象者の文書番号。スペースやドットを含めずに入力してください。
firstSurname	string	はい	照会対象者の第一姓。

リクエスト

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 <your_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 <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"))

Swift

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

<?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();

レスポンス

200 - 該当あり

{
  "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 - 該当なし

{
  "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 (パラメーター不足)

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

409 (不正な文書タイプ)

{
  "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 をサポートします。
• エラーハンドリング: 各種シナリオに対応した包括的なエラーレスポンスを提供します。

ユースケース

• バックグラウンド調査: 対象者に現行の収容記録があるかを確認します。
• 法的デューデリジェンス: 司法手続きにおける法的状態を確認します。
• セキュリティスクリーニング: 雇用やセキュリティクリアランスのための情報を検証します。
• 家族による確認: 親族による拘禁状況の確認を可能にします。
• コンプライアンス確認: 機微なポジションに関する規制遵守を確保します。