Check names against the UK Sanctions List
One HTTPS endpoint. Send a person or organisation, get back clear, possible_match or match, the list entries behind it, and the date of the official list we checked against.
Authentication
Every request needs your API key. We email it when you subscribe. Send it as a bearer token:
Authorization: Bearer sc_live_xxxxxxxxxxxxxxxxxxxxxxxx
Keep the key on your server and never put it in a web page or mobile app. We only store a scrambled copy, so we can't show it again. If you lose it or think it has leaked, sign in to your dashboard and create a new one; the old key stops working immediately.
Base URL: https://sanctionscheck.uk
POST /v1/check
Checks one person or organisation. Every check is recorded against your account with the list date it ran against.
| Field | Type | Notes |
|---|---|---|
type | string | person (default) or organisation |
firstName, lastName | string | Person. Accents are fine: Dvořák matches DVORAK. |
name | string | Organisation name, or a person's full name if you don't have it split (first and last words are used). |
dob | string | Optional, YYYY-MM-DD. Strongly recommended: it turns most name-only hits into a clear or a match. |
curl
curl https://sanctionscheck.uk/v1/check \
-H "Authorization: Bearer $SANCTIONSCHECK_KEY" \
-H "Content-Type: application/json" \
-d '{"firstName":"Vladimir","lastName":"Putin","dob":"1952-10-07"}'
Node.js
const res = await fetch("https://sanctionscheck.uk/v1/check", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.SANCTIONSCHECK_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({ firstName: "Jane", lastName: "Smith", dob: "1985-04-12" }),
});
const check = await res.json();
if (check.result !== "clear") {
// hold onboarding and review check.matches
}
Python
import os, requests
r = requests.post(
"https://sanctionscheck.uk/v1/check",
headers={"Authorization": f"Bearer {os.environ['SANCTIONSCHECK_KEY']}"},
json={"type": "organisation", "name": "Acme Trading LLC"},
timeout=30,
)
print(r.json()["result"])
Response
{
"id": "q8Yk2c0x1VbJ7f3T",
"result": "match",
"checkedAt": "2026-11-19T14:02:11.204Z",
"list": { "name": "UK Sanctions List (FCDO)", "reportDate": "2026-11-17" },
"query": { "type": "person", "firstName": "Vladimir", "lastName": "Putin", "dob": "1952-10-07" },
"matches": [
{
"uniqueId": "RUS0251",
"name": "Vladimir Vladimirovich PUTIN",
"nameType": "Primary Name",
"regime": "The Russia (Sanctions) (EU Exit) Regulations 2019",
"designationType": "Individual",
"dateDesignated": "25/02/2022",
"dob": "07/10/1952",
"strength": "match",
"reason": "Name and date of birth match a list entry"
}
],
"ruledOutByDob": 0
}
Keep the id: it's the reference for that check in your records and ours.
What the results mean
| result | Meaning | Suggested action |
|---|---|---|
clear | No list entry with this name, or every same-name entry has a different date of birth (counted in ruledOutByDob). | Proceed. |
possible_match | The name matches, but there's no date of birth on your side or the list's to confirm or rule it out. | Ask for or check the date of birth, then review manually. |
match | Name and date of birth agree with a list entry, or an organisation's name matches exactly. | Stop. Don't proceed; follow your sanctions procedure and report to OFSI if required. |
Names are compared exactly after removing accents, case and spacing differences, and aliases on the list are checked too. Where the list only gives a year of birth, we treat that as no date of birth, because a year alone produces too many false alarms.
A result is a screening aid, not legal advice. You remain responsible for your sanctions compliance decisions.
GET /v1/checks
Your check log, newest first: every check from the API or the dashboard, with the result and the list date it ran against. Optional query parameters: from and to (YYYY-MM-DD, inclusive), limit (1–200, default 50) and cursor (the next value from the previous page).
curl "https://sanctionscheck.uk/v1/checks?from=2026-11-01&to=2026-11-30" \
-H "Authorization: Bearer $SANCTIONSCHECK_KEY"
# { "checks": [ { "id": "...", "result": "clear", "checkedAt": "...", "list": {...}, "query": {...}, "matches": [] } ],
# "next": "2026-11-03T09:12:44.120Z" }
GET /v1/checks.csv
The same log as a CSV file for your money-laundering records (same from/to filters, up to 10,000 rows per download).
curl -o checks.csv "https://sanctionscheck.uk/v1/checks.csv?from=2026-11-01" \
-H "Authorization: Bearer $SANCTIONSCHECK_KEY"
Prefer clicking? Sign in to the dashboard with your account email to search, filter and download the log.
GET /v1/usage
Checks used this calendar month against your plan.
{ "plan": "professional", "status": "active", "month": "2026-11",
"checks": 412, "overage": 0, "monthlyAllowance": 2000 }
Checks over your plan’s monthly allowance (2,000 on Professional, 15,000 on Business) cost 10p each and appear on your next invoice.
POST /v1/billing-portal
Returns a short-lived link to Stripe's billing page, where you can update your card, download invoices, change plan or cancel.
curl -X POST https://sanctionscheck.uk/v1/billing-portal \
-H "Authorization: Bearer $SANCTIONSCHECK_KEY"
# { "url": "https://billing.stripe.com/p/session/..." }
Errors
Errors return JSON: { "error": "message" }.
| Status | When |
|---|---|
| 400 | Missing or invalid fields (for example, dob not in YYYY-MM-DD form). |
| 401 | Missing or invalid API key. |
| 402 | Subscription inactive (payment failed or cancelled). Use the billing portal. |
| 429 | Monthly allowance used up (only where overage billing isn't enabled on your plan). |
| 503 | The list is temporarily unavailable. We never answer clear without a list loaded, so retry shortly. |
The list we check
We check against the UK Sanctions List published by the Foreign, Commonwealth & Development Office, the single official UK list since OFSI's Consolidated List closed. We keep it up to date with daily updates. Every response gives the reportDate of the list it used.
We don't screen against EU, UN or US lists, PEP databases or adverse media.
Get a key
Subscribe on the pricing section and your key arrives by email within a minute.