Sanctions Screening
Screen a person or company against US sanctions and trade-restriction lists.
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"}'{
"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>requiredYour 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.
namestringrequiredPerson or entity name. Example: Northwind Trading LLC
countrystringCountry (optional). Example: AE
freshbooleanSkip the 7-day cache and run a new lookup. Charged as a normal lookup.
referencestringYour 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.
successbooleantrue when the lookup ran.
data.match_foundbooleanTrue when the screen returned one or more list entries for the name you sent.
data.matches[].namevalueThe name as it is written on the list, for side-by-side comparison with your record.
data.matches[].scorevalueHow close the listed name is to your input. Higher means a closer match.
data.matches[].listvalueThe list the entry sits on, such as the OFAC SDN list or the Commerce Entity List.
data.matches[].entity_typevalueWhether the listed party is an individual, an entity, a vessel or an aircraft.
data.matches[].programsvalueThe sanctions programs the party is designated under, where the list provides them.
data.matches[].addressesvalueAddresses and countries on the entry, which help rule out a same-name false positive.
meta.credits_usednumberCredits charged for this call.
meta.credits_remainingnumberYour balance after the call.
meta.cachedbooleantrue when the result came from the 7-day cache.
meta.request_idstringQuote 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.
| HTTP | Code | Meaning |
|---|---|---|
| 401 | unauthorized | The key is missing, malformed or revoked. |
| 402 | insufficient_credits | Your credits are used up and pay as you go is off or at its limit. |
| 422 | invalid_input | A field is missing or malformed. The field property names it. |
| 429 | rate_limited | Too many requests for this key. Wait for the Retry-After interval. |
| 500 | internal_error | Something failed on our side. Safe to retry. |
| 503 | source_unavailable | An 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