FBI 背景核查

API 参考

Endpoint

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

通过 documentType 与 documentNumber，或直接使用 fullName，对 FBI 公开发布的记录进行检索。当存在匹配时，响应可包含身份字段以及指向该对象的 FBI 公开 URL。

注意： 日期字段（出生日期或签发日期）必须采用 dd/mm/yyyy 格式。

请求头（Headers）

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

参数（Parameters）

info

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

名称	类型	必填	描述
documentType	string	否	待请求的证件类型。
documentNumber	string	否	待查询的证件号码，不含空格或圆点。
fullName	string	否	可不传 documentType 与 documentNumber，而直接传入个人或企业的姓名/名称。

使用场景

• 身份核验： 对照 FBI 公开信息核验证件。
• 合规审查： 用于敏感岗位或交易的筛查。
• 欺诈预防： 在建立合作关系之前确认身份。

请求（Request）

JavaScript

import axios from "axios";

const options = {
  method: "GET",
  url: "https://api.verifik.co/v2/fbi",
  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")
payload = ''
headers = {}
conn.request("GET", "/v2/fbi?fullName=", payload, headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))

Swift

var request = URLRequest(url: URL(string: "https://api.verifik.co/v2/fbi?fullName=")!,timeoutInterval: Double.infinity)
request.httpMethod = "GET"

let task = URLSession.shared.dataTask(with: request) { data, response, error in
  guard let data = data else {
    print(String(describing: error))
    return
  }
  print(String(data: data, encoding: .utf8)!)
}

task.resume()

PHP

<?php
require_once 'HTTP/Request2.php';
$request = new HTTP_Request2();
$request->setUrl('https://api.verifik.co/v2/fbi?fullName=');
$request->setMethod(HTTP_Request2::METHOD_GET);
$request->setConfig(array(
  'follow_redirects' => TRUE
));
try {
  $response = $request->send();
  if ($response->getStatus() == 200) {
    echo $response->getBody();
  }
  else {
    echo 'Unexpected HTTP status: ' . $response->getStatus() . ' ' .
    $response->getReasonPhrase();
  }
}
catch(HTTP_Request2_Exception $e) {
  echo 'Error: ' . $e->getMessage();
}

响应（Response）

200

{
  "data": {
    "documentType": "CC",
    "documentNumber": "80251972",
    "fullName": "WILVER VILLEGAS PALOMINO",
    "firstName": "WILVER",
    "lastName": "VILLEGAS PALOMINO",
    "arrayName": ["WILVER", "VILLEGAS", "PALOMINO"],
    "foundInFBI": true,
    "urlFBI": "https://www.fbi.gov/wanted/cei/wilver-villegas-palomino-"
  },
  "signature": {
    "dateTime": "June 28, 2022 12:36 PM",
    "message": "Certified by Verifik.co"
  }
}

404

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

409

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

备注

• 当存在公开的 FBI 页面时，会返回 foundInFBI 字段以及可选的 urlFBI 字段。