Run OFAC entity candidate evidence.

OFAC entity candidate evidence returns structured JSON. This example is static; the paid call returns a fresh result and settlement receipt.

{
  "request_id": "018f1f54-7f38-7ba2-8dc3-5f90272d9f1a",
  "service": "research.ofac-entity-search",
  "version": "1",
  "data": {
    "status": "candidates_found",
    "query": {
      "entityName": "AEROCARIBBEAN AIRLINES",
      "normalizedName": "aerocaribbean airlines",
      "entityType": "Entity",
      "minimumScore": 85,
      "maxResults": 5,
      "includeWeakAliases": false
    },
    "candidateCount": 1,
    "candidatesReturned": 1,
    "candidatesTruncated": false,
    "candidates": [
      {
        "uid": "36",
        "primaryName": "AEROCARIBBEAN AIRLINES",
        "entityType": "Entity",
        "listKind": "sdn",
        "listLabel": "SDN",
        "programs": [
          "CUBA"
        ],
        "countries": [
          "Cuba"
        ],
        "match": {
          "matchedName": "AEROCARIBBEAN AIRLINES",
          "matchedField": "primary",
          "aliasQuality": null,
          "score": 100.0,
          "method": "exact",
          "scoreAuthority": "API Acre; not the OFAC Sanctions List Search score"
        },
        "sourceFileUrl": "https://sanctionslistservice.ofac.treas.gov/api/PublicationPreview/exports/sdn.xml"
      }
    ],
    "dataset": {
      "snapshotFetchedAt": "2026-08-12T02:00:00+00:00",
      "cacheMaxAgeSeconds": 3600,
      "files": [
        {
          "listKind": "sdn",
          "listLabel": "SDN",
          "filename": "sdn.xml",
          "publishDate": "2026-08-07",
          "recordCount": 19199,
          "entityRecordCount": 9854,
          "sha256": "ac00228a68345e5c0d7174713cf97e5d5a8efe7cec5c2f540ed87106f49f7474",
          "sourceUrl": "https://sanctionslistservice.ofac.treas.gov/api/PublicationPreview/exports/sdn.xml"
        },
        {
          "listKind": "consolidated-non-sdn",
          "listLabel": "Consolidated Non-SDN",
          "filename": "consolidated.xml",
          "publishDate": "2026-07-27",
          "recordCount": 481,
          "entityRecordCount": 363,
          "sha256": "6c9eb74d6060a8c7075dd48054e087cb83c7ccd935dfd4df6700635e12d7c84f",
          "sourceUrl": "https://sanctionslistservice.ofac.treas.gov/api/PublicationPreview/exports/consolidated.xml"
        }
      ]
    },
    "source": "https://ofac.treasury.gov/sanctions-list-service",
    "retrievedAt": "2026-08-12T02:00:01+00:00",
    "limitations": [
      "Results are name-similarity candidates for manual review, not a determination that the queried entity is listed or that a transaction is permitted or prohibited.",
      "This search covers separately named Entity records and their aliases only; it excludes individuals, vessels, aircraft, ownership analysis, geographic restrictions, and entities blocked under OFAC's 50 Percent Rule but not separately listed.",
      "Different OFAC lists and program tags carry different restrictions; inspect the current official record, program, and legal authority before acting.",
      "Name-only screening can produce false positives and false negatives. Weak aliases are excluded by default because OFAC warns they may create many false hits."
    ],
    "guidance": {
      "automation": "https://ofac.treasury.gov/faqs/287",
      "fiftyPercentRule": "https://ofac.treasury.gov/faqs/10"
    },
    "disclaimer": "Evidence aid only. Not legal advice, a compliance certification, or a sole basis for an allow, deny, freeze, or reporting decision."
  },
  "meta": {
    "duration_ms": 42,
    "cached": false,
    "sources": [],
    "warnings": [],
    "next_actions": [
      {
        "service": "research.organization-evidence",
        "title": "Official supplier evidence report",
        "reason": "Add independent GLEIF legal-entity, USAspending prime-contract, and SEC filing-activity evidence for the organization name without turning the OFAC candidates into a verdict.",
        "method": "POST",
        "path": "/v1/research/organization-evidence",
        "price": "$0.1",
        "input_template": {
          "legal_name": "$request.entity_name"
        },
        "use_output": "Use the four source sections as separate evidence. Candidate similarity does not establish identity, sanctions status, cross-source linkage, or compliance clearance.",
        "handoff_path": "/catalog/research.organization-evidence",
        "checkout_path": "/try/research.organization-evidence",
        "sample_path": "/samples/research.organization-evidence",
        "maximum_atomic_usdc": "100000",
        "handoff_payment_required": false,
        "executes_automatically": false,
        "authorization_required": true
      }
    ]
  }
}