LinkinLegalDocs
APIDeveloper console
Reference

Search entities

Find sanctioned entities or politically exposed persons by text in the caption, with filters, sorting and paging.

GET/sanctions/search

Authorization

bearerAuth
AuthorizationBearer <token>

In: header

Query Parameters

query?string

Text to find inside the entity caption. It needs one word with 3 or more letters or digits. Leave it out to list entities.

page?integer

Page number. The first page is 1.

Range1 <= value
Default1
per_page?integer

Results on one page.

Range1 <= value <= 100
Default50
type?string

The list to search: sanctions, or politically exposed persons.

Default"sanction"

Value in

  • "sanction"
  • "pep"
dataset?string

Only these source lists. Comma-separated names from GET /sanctions/datasets.

schema?string

Only these entity types. Comma-separated names from GET /sanctions/schemas.

country?string

Only these countries. Comma-separated two-letter codes from GET /sanctions/countries.

sort_method?string

relevance puts whole-word hits first. date sorts by the last change. alpha sorts by caption. Default: relevance when query is set, else date.

Value in

  • "relevance"
  • "alpha"
  • "date"
sort_order?string

Direction for date and alpha. Not used by relevance.

Default"desc"

Value in

  • "asc"
  • "desc"
target?boolean

true returns entities that are listed themselves. false returns the supporting records (relatives, associates, linked companies).

Defaulttrue
whole_word?boolean

true matches query as whole words only.

Defaultfalse
from_date?string

Only entities changed on or after this day.

Formatdate
to_date?string

Only entities changed on or before this day.

Formatdate

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/sanctions/search?query=putin&dataset=us_ofac_sdn%2Ceu_fsf&schema=Person%2CCompany&country=ru%2Cby&from_date=2026-01-01&to_date=2026-01-31" \  -H "Authorization: Bearer lil_sk_..."
{  "results": [    {      "id": "Q7747",      "caption": "Vladimir Putin",      "schema": "Person",      "datasets": [        "us_ofac_sdn",        "eu_fsf",        "gb_fcdo_sanctions"      ],      "last_change": "2026-04-21T14:42:24",      "properties": {        "name": [          "Vladimir Vladimirovitj PUTIN",          "Влади́мир Влади́мирович ПУ́ТИН"        ],        "country": [          "ru"        ]      },      "listingStatus": "listed"    }  ],  "total": 2,  "page": 1,  "per_page": 1,  "total_pages": 2}

Last updated on

Limits

What the LinkinLegal sanctions endpoints cannot do: scripts that are not transliterated, entity kinds that cannot be matched, the candidate ceiling and response times.

Match a subject POST

Score one person, company or vessel against the sanctions and PEP lists. Returns candidates with a score from 0 to 1 and the reason for each score.