OFAC 배경 조회

API 레퍼런스

엔드포인트

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

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

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

활용 사례

• 제재 컴플라이언스: OFAC 집행 대상인 차단 거래 상대를 회피합니다.
• 위험 완화: 미국 및 국제 무역 규정 위반 시 부과되는 제재를 줄입니다.
• KYC 및 AML: 은행, 보험, 부동산 분야의 고객 검증을 강화합니다.

요청(Request)

JavaScript

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);
}

Python

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

Swift

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

<?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 미발견)

{
  "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"
}

200 (OFAC 발견)

{
  "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"
}

404

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

409 (매개변수 누락)

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

409 (잘못된 문서 종류)

{
  "code": "MissingParameter",
  "message": "documentType must be one of: [DNIAR]"
}

비고

• 응답에는 foundInOFAC 값과, 일치 시 SDN 항목에 대한 fullLink 등 OFAC 상세 메타데이터가 포함됩니다.