国連（ONU）身元照会

API リファレンス

エンドポイント

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

documentType と documentNumber、または fullName を用いて、対象者または法人が国連の制裁リストに掲載されているかを照会します。取引相手のスクリーニングにおいて、グローバルなコンプライアンス、KYC、AML ワークフローの結果として活用できます。

注: 日付（生年月日や発行日）は dd/mm/yyyy 形式で指定してください。

ヘッダー

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

パラメーター

info

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

名前	型	必須	説明
documentType	string	いいえ	照会する文書タイプ。
documentNumber	string	いいえ	照会する文書番号。スペースやドットを含めずに入力してください。
fullName	string	いいえ	documentType と documentNumber の代わりに、対象者または企業の氏名を直接指定できます。

ユースケース

• 国際的なコンプライアンス: オンボーディングや取引前に、個人および法人を国連制裁に対して検証します。
• リスク評価: 制裁対象者と関わることによる金融・レピュテーションリスクを軽減します。
• 規制プログラム: 銀行・金融・保険における KYC/AML 要件を支援します。

リクエスト

JavaScript

import axios from "axios";

const options = {
  method: "GET",
  url: "https://api.verifik.co/v2/onu",
  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/onu?fullName=", 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/onu?fullName=")! 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/onu?fullName=', [
  'headers' => [
    'Accept' => 'application/json',
    'Authorization' => 'JWT token',
  ],
]);

echo $response->getBody();

レスポンス

200

{
  "data": {
    "documentType": "CC",
    "documentNumber": "1234567894",
    "fullName": "MATEO VERIFIK",
    "firstName": "MATEO",
    "lastName": "VERIFIK",
    "arrayName": ["MATEO", "VERIFIK"],
    "foundInONU": true
  },
  "signature": {
    "dateTime": "August 4, 2022 3:57 PM",
    "message": "Certified by Verifik.co"
  }
}

404

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

409

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

注意事項

• 国連制裁の検証: 個人および法人を対象とします。
• 構造化されたレスポンス: 統合に適しており、上記のとおり JavaScript、Python、PHP、Swift のサンプルをサポートします。