sanctionscheck.uk
API reference · v1

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.

FieldTypeNotes
typestringperson (default) or organisation
firstName, lastNamestringPerson. Accents are fine: Dvořák matches DVORAK.
namestringOrganisation name, or a person's full name if you don't have it split (first and last words are used).
dobstringOptional, 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

resultMeaningSuggested action
clearNo list entry with this name, or every same-name entry has a different date of birth (counted in ruledOutByDob).Proceed.
possible_matchThe 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.
matchName 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" }.

StatusWhen
400Missing or invalid fields (for example, dob not in YYYY-MM-DD form).
401Missing or invalid API key.
402Subscription inactive (payment failed or cancelled). Use the billing portal.
429Monthly allowance used up (only where overage billing isn't enabled on your plan).
503The 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.

See plans