OFAC 背景核查
API 参考
Endpoint
https://api.verifik.co/v2/ofac
通过 documentType 与 documentNumber,或直接使用 fullName,对个人或机构是否出现在美国财政部海外资产控制办公室(OFAC)特别指定国民(SDN)与被冻结人员名单中进行核查。返回结果可用于制裁合规、贸易筛查及 KYC/AML 流程。
注意: 日期字段(出生日期或签发日期)必须采用 dd/mm/yyyy 格式。
请求头(Headers)
| 名称 | 取值 |
|---|---|
| Content-Type | application/json |
| Authorization | Bearer <token> |
参数(Parameters)
info
有关支持的证件类型及其专属必填参数的完整清单,请参阅 证件类型 指南。
| 名称 | 类型 | 必填 | 描述 |
|---|---|---|---|
documentType | string | 否 | 待请求的证件类型。 |
documentNumber | string | 否 | 待查询的证件号码,不含空格或圆点。 |
fullName | string | 否 | 可不传 documentType 与 documentNumber,而直接传入个人或企业的姓名/名称。 |
使用场景
- 制裁合规: 避免与受 OFAC 制裁的对象发生业务往来。
- 风险缓释: 降低因违反美国及国际贸易规则而产生的处罚风险。
- KYC 与 AML: 加强银行、保险、房地产等行业的客户筛查。
请求(Request)
- JavaScript
- Python
- Swift
- PHP
import axios from "axios";
const options = {
method: "GET",
url: "https://api.verifik.co/v2/ofac",
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);
}
import http.client
conn = http.client.HTTPSConnection("api.verifik.co")
payload = ''
headers = {}
conn.request("GET", "/v2/ofac?fullName=Mateo%20Verifik", payload, headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
var request = URLRequest(url: URL(string: "https://api.verifik.co/v2/ofac?fullName=Mateo%20Verifik")!,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
require_once 'HTTP/Request2.php';
$request = new HTTP_Request2();
$request->setUrl('https://api.verifik.co/v2/ofac?fullName=Mateo Verifik');
$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(未在 OFAC 中找到)
- 200(在 OFAC 中找到)
- 404
- 409(缺少参数)
- 409(无效的证件类型)
{
"data": {
"documentType": "CC",
"documentNumber": "80927603",
"fullName": "MATEO ANDRES VERIFIK",
"firstName": "MATEO ANDRES",
"lastName": "VERIFIK",
"arrayName": ["MATEO", "ANDRES", "VERIFIK"],
"foundInOFAC": false,
"details": {}
},
"signature": {
"dateTime": "June 27, 2025 4:33 PM",
"message": "Certified by Verifik.co"
},
"id": "U4RBQ"
}
{
"data": {
"documentType": "CURP",
"documentNumber": "VILJ580411HSLLRN09",
"fullName": "JUAN CARLOS VILLEGAS LOERA",
"firstName": "JUAN CARLOS",
"lastName": "VILLEGAS LOERA",
"arrayName": ["JUAN", "CARLOS", "VILLEGAS", "LOERA"],
"foundInOFAC": true,
"details": {
"fullLink": "https://sanctionssearch.ofac.treas.gov/Details.aspx?id=15785",
"type": "Individual",
"list": "SDN",
"lastName": "VILLEGAS LOERA",
"program": "SDNTK",
"firstName": "Juan Carlos",
"nationality": "",
"title": "",
"citizenship": "",
"dateOfBirth": "11 Apr 1958",
"placeOfBirth": "Culiacan, Sinaloa, Mexico",
"remarks": "(Linked To: BUENOS AIRES SERVICIOS, S.A. DE C.V.; Linked To: ESTACIONES DE SERVICIOS CANARIAS, S.A. DE C.V.; Linked To: GASODIESEL Y SERVICIOS ANCONA, S.A. DE C.V.; Linked To: GASOLINERA ALAMOS COUNTRY, S.A. DE C.V.; Linked To: GASOLINERA Y SERVICIOS VILLABONITA, S.A. DE C.V.; Linked To: PETROBARRANCOS, S.A. DE C.V.; Linked To: SERVICIOS CHULAVISTA, S.A. DE C.V.)",
"identifications": [
{
"type": "C.U.R.P.",
"idNumber": "VILJ580411HSLLRN09",
"country": "Mexico",
"issueDate": null,
"expireDate": null
}
],
"addresses": [
{
"address": "Calle Golfo de California No. 1635",
"city": "Culiacan",
"stateOrProvince": "Sinaloa",
"postalCode": "",
"country": "Mexico"
}
]
}
},
"signature": {
"dateTime": "June 27, 2025 4:48 PM",
"message": "Certified by Verifik.co"
},
"id": "1LMO7"
}
{
"code": "NotFound",
"message": "Record not found."
}
{
"code": "MissingParameter",
"message": "missing documentType\n. missing documentNumber\n"
}
{
"code": "MissingParameter",
"message": "documentType must be one of: [DNIAR]"
}
备注
- 响应包含
foundInOFAC字段;若命中,还可包含 OFAC 的详细元数据,例如指向 SDN 条目的fullLink。