인터폴 배경 조회

API 레퍼런스

엔드포인트

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

본 엔드포인트는 자연인 또는 법인에 대한 인터폴 연계 형사 배경 정보를 documentType과 documentNumber, 또는 fullName만으로 조회합니다. 정상 응답에는 신원 필드가 포함되며, 기록이 존재할 경우 매치 상세 정보가 함께 반환됩니다. 본 서비스는 안전하고 권한 있는 법 집행 및 보안 용도로 사용되도록 설계되었습니다.

참고: 날짜(출생일 또는 발급일)는 dd/mm/yyyy 형식이어야 합니다.

헤더(Headers)

이름	값
Content-Type	application/json
Authorization	Bearer <token>

매개변수(Parameters)

info

지원되는 문서 종류의 전체 목록과 각 종류별 필수 매개변수는 Document Types 가이드를 참고해 주세요.

이름	형식	필수	설명
documentType	string	아니오	조회할 문서 종류
documentNumber	string	아니오	조회할 문서 번호. 공백이나 점 없이 입력합니다.
fullName	string	아니오	documentType과 documentNumber 대신 개인 또는 법인의 이름을 직접 전달할 수 있습니다.

활용 사례

• 형사 배경 검증: 채용, 보안 등급 부여 또는 법적 컴플라이언스(국제 기록 포함)에 활용합니다.
• 법 집행: 권한 있는 기관이 인터폴 데이터를 기반으로 검증을 수행합니다.

요청(Request)

JavaScript

import axios from "axios";

const options = {
  method: "GET",
  url: "https://api.verifik.co/v2/interpol",
  params: { documentType: "CC", documentNumber: "80251972" },
  headers: {
    Accept: "application/json",
    Authorization: "jwt <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': "JWT token"
}

conn.request("GET", "/v2/interpol?fullName=IVAN%20LUCIANO%20MARQUEZ%20MARIN%20ARANGO", headers=headers)

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

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

Swift

import Foundation

let headers = [
  "Accept": "application/json",
  "Authorization": "JWT token"
]

let request = NSMutableURLRequest(url: NSURL(string: "https://api.verifik.co/v2/interpol?fullName=IVAN%20LUCIANO%20MARQUEZ%20MARIN%20ARANGO")! 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/interpol?fullName=IVAN LUCIANO MARQUEZ MARIN ARANGO', [
  'headers' => [
    'Accept' => 'application/json',
    'Authorization' => 'JWT token',
  ],
]);

echo $response->getBody();

응답(Response)

200 (발견)

{
  "data": {
    "documentType": "CC",
    "documentNumber": "19304877",
    "firstName": "IVAN LUCIANO MARQUEZ",
    "lastName": "MARIN ARANGO",
    "fullName": "IVAN LUCIANO MARQUEZ MARIN ARANGO",
    "arrayName": ["IVAN", "LUCIANO", "MARQUEZ", "MARIN", "ARANGO"],
    "foundInInterpol": true,
    "details": {
      "totalCards": "2",
      "cards": [
        {
          "arrestWarrants": [
            {
              "issuingCountryId": "CO",
              "charge": "ARTICULO 162.  - RECLUTAMIENTO ILÍCITO \r\nARTICULO 135-6 - HOMICIDIO EN PERSONA PROTEGIDA \r\nARTICULO 165 y 166 causal 3 - DESAPARICIÓN FORZADA AGRAVADA POR LA MENOR EDAD DE LA VÍCTIMA"
            }
          ],
          "weight": "0",
          "languagesSpokenIds": ["SPA"],
          "height": "1.75",
          "sexId": "M",
          "countryOfBirthId": "CO",
          "distinguishingMarks": null,
          "eyesColorsId": null,
          "hairsId": null,
          "placeOfBirth": "FLORENCIA - CAQUETA"
        }
      ]
    }
  },
  "signature": {
    "dateTime": "June 16, 2025 4:31 PM",
    "message": "Certified by Verifik.co"
  },
  "id": "PHVXK"
}

200 (미발견)

{
  "data": {
    "documentType": "CC",
    "documentNumber": "123456789",
    "firstName": "MATEO",
    "lastName": "VERIFIK",
    "fullName": "MATEO VERIFIK",
    "arrayName": ["MATEO", "VERIFIK"],
    "foundInInterpol": false,
    "details": {}
  },
  "signature": {
    "dateTime": "June 16, 2025 4:32 PM",
    "message": "Certified by Verifik.co"
  },
  "id": "FX5TI"
}

404

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

409

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

비고

• 본 서비스는 인터폴 데이터베이스에 접근하며, 권한 있는 법 집행 및 보안 기관 전용으로 제공됩니다. 무단 사용은 엄격히 금지됩니다.
• 조회 데이터는 매우 민감하며 국제 개인정보 보호 및 데이터 보호 법령의 적용을 받습니다. 신중하게 다루고 관련 규정 준수를 보장해 주십시오.
• 중요한 의사결정에 활용할 경우 인터폴 공식 채널 또는 현지 당국을 통해 정보를 추가로 검증하시기 바랍니다.
• 형사 배경 조회: 인터폴 연계 기록을 대상으로 합니다.
• 구조화된 응답: 통합에 적합한 형식으로 데이터를 반환하며, 위에서 JavaScript, Python, PHP, Swift 예제를 제공합니다.