API Acre · Research Ofac Entity Search

import { wrapFetchWithPayment } from "@x402/fetch";
import { privateKeyToAccount } from "viem/accounts";

const account = privateKeyToAccount(process.env.PRIVATE_KEY);
const fetchWithPay = wrapFetchWithPayment(fetch, account);

const res = await fetchWithPay("https://apiacre.com/v1/research/ofac-entity-search", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    "entity_name": "AEROCARIBBEAN AIRLINES",
    "include_weak_aliases": false,
    "max_results": 5,
    "minimum_score": 85
  }),
});
const data = await res.json();

curl -X POST \
  "https://apiacre.com/v1/research/ofac-entity-search" \
  -H "Content-Type: application/json" \
  -d '{"entity_name":"AEROCARIBBEAN AIRLINES","include_weak_aliases":false,"max_results":5,"minimum_score":85}' \
  -H "X-PAYMENT: <signed x402 payment>"

{
  "data": {
    "candidateCount": 1,
    "candidates": [
      {
        "entityType": "Entity",
        "listKind": "sdn",
        "listLabel": "SDN",
        "primaryName": "AEROCARIBBEAN AIRLINES",
        "uid": "36"
      }
    ],
    "candidatesReturned": 1,
    "candidatesTruncated": false,
    "dataset": {
      "cacheMaxAgeSeconds": 3600,
      "files": [
        {
          "filename": "sdn.xml",
          "listKind": "sdn",
          "listLabel": "SDN",
          "publishDate": "2026-08-07",
          "recordCount": 19199
        }
      ],
      "snapshotFetchedAt": "2026-08-12T02:00:00+00:00"
    },
    "disclaimer": "Evidence aid only. Not legal advice, a compliance certification, or a sole ba...",
    "guidance": {
      "automation": "https://ofac.treasury.gov/faqs/287",
      "fiftyPercentRule": "https://ofac.treasury.gov/faqs/10"
    },
    "limitations": [
      "Results are name-similarity candidates for manual review, not a determination...",
      "This search covers separately named Entity records and their aliases only; it...",
      "Different OFAC lists and program tags carry different restrictions; inspect t...",
      "Name-only screening can produce false positives and false negatives. Weak ali..."
    ],
    "query": {
      "entityName": "AEROCARIBBEAN AIRLINES",
      "entityType": "Entity",
      "maxResults": 5,
      "minimumScore": 85,
      "normalizedName": "aerocaribbean airlines"
    },
    "retrievedAt": "2026-08-12T02:00:01+00:00",
    "source": "https://ofac.treasury.gov/sanctions-list-service",
    "status": "candidates_found"
  },
  "meta": {
    "cached": false,
    "duration_ms": 42,
    "next_actions": [
      {
        "method": "POST",
        "path": "/v1/research/organization-evidence",
        "reason": "Add independent GLEIF legal-entity, USAspending prime-contract, and SEC filin...",
        "service": "research.organization-evidence",
        "title": "Official supplier evidence report"
      }
    ],
    "sources": [],
    "warnings": []
  },
  "request_id": "018f1f54-7f38-7ba2-8dc3-5f90272d9f1a",
  "service": "research.ofac-entity-search",
  "version": "1"
}