{"uid":"cap_GKgvRjC5Vpx8_XaRrGAai","slug":"ofac-sdn-entity-name-search-dd17e166","name":"OFAC SDN Entity Name Search","description":"Compare a business or organization name with separately named Entity records and aliases in the official OFAC SDN and Consolidated Non-SDN files, returning deterministic candidate scores, program tags, source hashes, and freshness evidence without issuing an allow or block verdict.","url":"https://apiacre.com/v1/research/ofac-entity-search?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"entity_name":{"type":"string"},"max_results":{"type":"integer"},"minimum_score":{"type":"integer"},"include_weak_aliases":{"type":"boolean"}}},"responseSchema":{"type":"json","example":{"data":{"query":{"entityName":"AEROCARIBBEAN AIRLINES","entityType":"Entity","maxResults":5,"minimumScore":85,"normalizedName":"aerocaribbean airlines"},"source":"https://ofac.treasury.gov/sanctions-list-service","status":"candidates_found","dataset":{"files":[{"filename":"sdn.xml","listKind":"sdn","listLabel":"SDN","publishDate":"2026-08-07","recordCount":19199}],"snapshotFetchedAt":"2026-08-12T02:00:00+00:00","cacheMaxAgeSeconds":3600},"guidance":{"automation":"https://ofac.treasury.gov/faqs/287","fiftyPercentRule":"https://ofac.treasury.gov/faqs/10"},"candidates":[{"uid":"36","listKind":"sdn","listLabel":"SDN","entityType":"Entity","primaryName":"AEROCARIBBEAN AIRLINES"}],"disclaimer":"Evidence aid only. Not legal advice, a compliance certification, or a sole ba...","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..."],"retrievedAt":"2026-08-12T02:00:01+00:00","candidateCount":1,"candidatesReturned":1,"candidatesTruncated":false},"meta":{"cached":false,"sources":[],"warnings":[],"duration_ms":42,"next_actions":[{"path":"/v1/research/organization-evidence","title":"Official supplier evidence report","method":"POST","reason":"Add independent GLEIF legal-entity, USAspending prime-contract, and SEC filin...","service":"research.organization-evidence"}]},"service":"research.ofac-entity-search","version":"1","request_id":"018f1f54-7f38-7ba2-8dc3-5f90272d9f1a"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_GbOG5hdKmFwbVJtdYwDOk","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Searches OFAC SDN and Consolidated Non-SDN sanction lists by entity name, returning scored candidate matches with program tags, alias quality, and source file evidence without issuing a compliance verdict.","exampleAgentPrompt":"Can you search the OFAC SDN and Consolidated Non-SDN lists for 'Aerocaribbean Airlines' as an Entity type, return up to 5 candidates with a minimum score of 85, and tell me the match score, which sanctions programs it's tagged under, and how fresh the underlying list data is?","exampleUseCases":[{"title":"Pre-onboarding vendor sanctions check","prompt":"Before we onboard this new supplier 'Crimson Star Trading LLC', can you screen it against the OFAC SDN list as an Entity and give me the top 3 candidates with at least an 80% match score, along with any sanctions program tags?"},{"title":"KYC screening for a foreign counterparty","prompt":"We're about to wire funds to a company called 'Global Metals Group'. Run it through the OFAC SDN and Consolidated Non-SDN lists as an Entity, return up to 5 matches scoring 90 or above, and include any alias matches so our compliance team can review."},{"title":"Sanctions research with freshness verification","prompt":"Search OFAC records for 'Rosoboronexport' as an Entity with a minimum score of 85 and up to 5 candidates — I also need the SHA256 hash and publication date of the underlying SDN file so I can confirm we're working off a current snapshot."}],"resultDescription":"Returns a JSON object containing: query echo (normalized name, entity type, thresholds), dataset metadata (per-file SHA256 hashes, publication dates, record counts, snapshot fetch timestamp, cache max-age), and an array of scored candidates each with match score, match method (exact/fuzzy), matched name, alias quality, list kind (SDN or Consolidated Non-SDN), sanctions program codes, associated countries, and source file URL. Includes guidance links and a disclaimer that results are for review only and do not constitute a compliance determination.","failureModes":["No candidates found if the name has no similarity above the minimum score threshold — status returns 'no_candidates'","Stale snapshot if the OFAC list has not refreshed within the cache window — freshness evidence indicates last fetch time","Malformed entity name or unsupported entity type returns a validation error","Score threshold set too high may exclude partial matches that warrant manual review","Network timeout if the OFAC source list is temporarily unavailable during snapshot refresh"],"whenToPreferThis":"Use this endpoint when you need deterministic, auditable OFAC name-matching with cryptographic source evidence (SHA256 file hashes and publication dates) rather than a black-box allow/block verdict. It is ideal for compliance workflows that require human review of candidates, integration into AML/KYC pipelines, or any context where you need to document exactly which version of the OFAC list was searched. Prefer it over generic sanctions APIs when you need program-level tags, alias quality indicators, and freshness timestamps for regulatory audit trails.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-12T18:38:00.557Z","isFirstParty":false,"canonicalSlug":"ofac-sdn-entity-name-search-dd17e166"}