NewConnect Claude, Cursor, ChatGPT, and other AI agents to API Ninjas via our MCP server →

Sanctions Screening API

The Sanctions Screening API screens a name (person, entity, vessel, or aircraft) against major government sanctions lists with fuzzy name matching and returns ranked matches with confidence scores, identifiers, and the underlying designation details.

This data is informational only and is not a substitute for a full compliance in a KYC program.

Available endpoints:

(4.7)

From 7,878 users

1,500+

Applications using this API

API Status

Online - All Systems Operational

API Response Times

Average
P50
P75
P90
P95
418ms446ms500ms659ms1287ms

Didn't find what you were looking for? Suggest an improvement

/v1/sanctionsscreening GET

https://api.api-ninjas.com/v1/sanctionsscreening

Returns ranked sanctions matches for the supplied name with confidence scores from 0 to 100.

List coverage by subscription tier:

  • Free — OFAC SDN only, individuals only, limited response fields.
  • Developer — adds the EU Consolidated Financial Sanctions List and entity screening.
  • Business and above — adds UK, UN, and Australian DFAT lists; vessel and aircraft screening; phonetic and transliteration matching; full per-source list_versions and stale_data_warning on every response.

See pricing for a complete feature comparison.

Parameters

  • name  required

    Name to screen. Full name; ordering doesn't matter.

  • entity_type  optionalpremium only

    Restrict to a specific entity type. One of: individual, entity, vessel, aircraft. Vessel and aircraft require Business tier or above.

  • country  optionalpremium only

    ISO 3166-1 alpha-2 country code (e.g. RU) to filter results by nationality or jurisdiction.

  • dob  optionalpremium only

    Date of birth in YYYY-MM-DD format. Loose match: ±1 year.

  • nationality  optionalpremium only

    ISO 3166-1 alpha-2 nationality filter.

  • sources  optionalpremium only

    Comma-separated subset of OFAC,EU,UK,UN,AU to scope the screen.

  • min_score  optionalpremium only

    Minimum confidence score (0-100) to return. Defaults to 70.

Headers

  • X-Api-Key  required

    API Key associated with your account.

Response

A JSON object with the following top-level fields, or an error if the request is unsuccessful.

  • matches

    Array of ranked match objects. Each object contains the fields below — fields marked premium only are returned only on paid tiers; Free responses include just the four unbadged fields.

    • confidence_score — integer 0-100.
    • match_strength — strong or weak.
    • source_list — which government list the match came from.
    • primary_name — the canonical designated name.
    • designation_date — date the entity was designated.
    • source_id — upstream record ID. premium only
    • entity_type — individual / entity / vessel / aircraft. premium only
    • matched_alias — the alias the query matched against. premium only
    • alias_quality — primary / aka_strong / aka_weak. premium only
    • date_of_birth — array of DOBs. premium only
    • place_of_birth — array of POBs. premium only
    • nationalities — array of nationalities. premium only
    • addresses — array of known addresses (raw strings on Developer, structured dicts on Business+). premium only
    • identifiers — passport / IMO / tail number / national ID list. premium only
    • sanction_programs — list of OFAC/EU/UK/UN/AU program codes (first only on Developer; full list on Business+). premium only
    • source_url — link to the upstream record. premium only
    • raw_record — original upstream XML/JSON payload. premium only
    • last_modified — Unix timestamp of last upstream change. premium only
    • score_breakdown — per-signal breakdown of the confidence score (debug). premium only
  • list_versionspremium only

    Per-source list-version dates (YYYY-MM-DD) active at screen time.

  • stale_data_warningpremium only

    Present when any source list is more than 7 days behind.

  • screened_at

    Unix timestamp (seconds) at which the screen was performed.

Per our Zero Data Retention policy, screen results are not stored on our servers. Persist the response on your end if you need an audit trail.

Sample Request Live Demo!

name

Try this API endpoint with all available parameters in our API playground

https://api.api-ninjas.com/v1/sanctionsscreening?name=Vladimir%20Putin

Headers

X-Api-KeyLog in or sign up to get your API Key

Sample Response

JSON

Code Examples

1 2 curl -X GET "https://api.api-ninjas.com/v1/sanctionsscreening?name=Vladimir%20Putin" \ -H "X-Api-Key: YOUR_API_KEY"

If your programming language is not listed in the Code Example above, you can still make API calls by using a HTTP request library written in your programming language and following the above documentation.