Skip to content
Compliance & Registries

Sanctions Screening

Screen a person or company against US sanctions and trade-restriction lists.

POST/v1/sanctions-screening
3 credits / screenBulk supportedUS Consolidated Screening List (13 lists)
Request
curl -X POST https://api.1lookup.dev/v1/sanctions-screening \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"Northwind Trading LLC"}'
Response
{
  "success": true,
  "data": {
    "query": {
      "name": "Northwind Trading LLC",
      "country": "AE"
    },
    "match_found": true,
    "match_count": 2,
    "lists_checked": 13,
    "matches": [
      {
        "name": "NORTHWIND TRADING L.L.C.",
        "score": 0.96,
        "list": "Specially Designated Nationals (SDN)",
        "agency": "Treasury (OFAC)",
        "entity_type": "entity",
        "programs": [
          "RUSSIA-EO14024"
        ],
        "aliases": [
          "Northwind Trading Co"
        ],
        "addresses": [
          {
            "address": "Office 1204, Example Tower",
            "city": "Dubai",
            "country": "AE"
          }
        ]
      },
      {
        "name": "NORTHWIND TRADE FZE",
        "score": 0.81,
        "list": "Entity List",
        "agency": "Commerce (BIS)",
        "entity_type": "entity",
        "programs": [],
        "aliases": [],
        "addresses": [
          {
            "address": "Warehouse 7, Example Free Zone",
            "city": "Sharjah",
            "country": "AE"
          }
        ]
      }
    ],
    "screened_at": "2026-11-18T14:02:11Z"
  },
  "meta": {
    "credits_used": 3,
    "credits_remaining": 999,
    "cached": false,
    "request_id": "req_8f3a2c1e9b7d"
  }
}

Authorization

Authorizationstring<bearer>required

Your API key as a Bearer token. Live keys start with 1lk_live_. Test keys start with 1lk_test_ and return this endpoint's sample response without spending credits. See authentication.

Body

Send the fields as a JSON object with Content-Type: application/json.

namestringrequired

Person or entity name. Example: Northwind Trading LLC

countrystring

Country (optional). Example: AE

freshboolean

Skip the 7-day cache and run a new lookup. Charged as a normal lookup.

referencestring

Your own identifier, echoed back in meta and shown in lookup history.

Response

A 200 response carries the result in data and the cost of the call in meta. These are the fields most integrations read.

successboolean

true when the lookup ran.

data.match_foundboolean

True when the screen returned one or more list entries for the name you sent.

data.matches[].namevalue

The name as it is written on the list, for side-by-side comparison with your record.

data.matches[].scorevalue

How close the listed name is to your input. Higher means a closer match.

data.matches[].listvalue

The list the entry sits on, such as the OFAC SDN list or the Commerce Entity List.

data.matches[].entity_typevalue

Whether the listed party is an individual, an entity, a vessel or an aircraft.

data.matches[].programsvalue

The sanctions programs the party is designated under, where the list provides them.

data.matches[].addressesvalue

Addresses and countries on the entry, which help rule out a same-name false positive.

meta.credits_usednumber

Credits charged for this call.

meta.credits_remainingnumber

Your balance after the call.

meta.cachedboolean

true when the result came from the 7-day cache.

meta.request_idstring

Quote this when you contact support.

Errors

A failed request returns success: false with an error object, and is never charged. The full list is on the errors page.

HTTPCodeMeaning
401unauthorizedThe key is missing, malformed or revoked.
402insufficient_creditsYour credits are used up and pay as you go is off or at its limit.
422invalid_inputA field is missing or malformed. The field property names it.
429rate_limitedToo many requests for this key. Wait for the Retry-After interval.
500internal_errorSomething failed on our side. Safe to retry.
503source_unavailableAn upstream source did not answer in time. Safe to retry.

Billing

3 credits / screen. Charged when the lookup runs and returns a result. Errors are never charged, and repeating the same input within 7 days is served from cache at no charge.

Product overview and use cases