Sanction check

In the case of an ambiguous response – when the “match” concerns more than one person/company – all results will be returned.

In the case of a positive verification (listed on sanctions lists), all available information about the given person/company and the imposed sanctions will always be returned (for a person: possible dates of birth or year of birth, possible aliases; for a company/organization: possible alternative names; all responses include the type of sanctions list and its reference number).

Sanction individual person check

Perform sanction lists check for individual person

POST/v2/sanction-lists/check/person

Perform sanction lists check for a person.

Request body

namestringRequired

Person first name

surnamestringRequired

Person last name

referenceIdstringOptional

Check id that might be used for GET request and return latest related response. If not provided the UUID is generated.

Request Example


curl --location 'https://api-test.simpl.rent/v2/sanction-lists/check/person' \
--header 'Authorization: <API key>' \
--header 'Content-Type: application/json' \
--data '{
    "name": "vladimir",
    "surname": "putin"
}'

Response Example - no surname provided


{
    "status": 400,
    "timestamp": "2025-10-01 10:00:00",
    "message": "Surname is required"
}

Responses described in GET

Sanction entity check

Perform sanction lists check for an entity (company or organization by its name).

POST/v2/sanction-lists/check/entity

Perform sanction lists check for an entity.

Request body

namestringRequired

Person first name

referenceIdstringOptional

Check id that might be used for GET request and return latest related response. If not provided the UUID is generated.

Request Example


curl --location 'https://api-test.simpl.rent/v2/sanction-lists/check/entity' \
--header 'Authorization: <API key>' \
--header 'Content-Type: application/json' \
--data '{
    "name": "ISIS",
    "referenceId": "9a5b060f-4340-42d5-acd5-aa61e63263b8"
}'

Responses described in GET

Returns check result related with referenceId person or entity. If more than one check was performed with same referenceId only latest is returned.

GET/v2/sanction-lists/results/{id}

Fetch sanction check result.

Path parameters

idstring

ID (referenceId) provided or returned in response when requesting check.

Returns

referenceIdstringOptional

ID (referenceId) provided or returned in response when requesting check.

sanctionsFoundbooleanOptional

If request succeeded then true/false value. In case of error parameter is not present.

detailsobject arrayOptional

Returned if request succeeded. In case of sanctions found it contains object list with details otherwise is an empty array

namestringRequired

Provided full name

listTypestringRequired

Type of list where match was found

referencestringRequired

objectTypeenum PERSON|ENTITYRequired

Match object type

nameAliasesstring arrayOptional

List of names related with that entry. Different variations or languages.

birthYearAliasesstring arrayOptional

List of birth year related with that entry.

birthDateAliasesstring arrayOptional

List of birth dates related with that entry.

commentstringOptional

Additional comment about found entry

errorstringOptional

Error message in case of request error

Request Example


curl --location --request GET 'https://api-test.simpl.rent/v2/sanction-lists/results/{id}' \
     --header 'Authorization: <API key>'

Response Example - no sanctions found


{
    "externalId": "38dcb193-6410-4d76-abaf-3457c6426ba1",
    "sanctionsFound": false,
    "details": []
}

Response Example - error occured during check


{
    "referenceId": "762ff3ee-43ae-4fba-8c51-7b2082d5e492",
    "error": "No sanction list check result found for the given reference ID"
}

Response Example - sanction entiries found for person: vladimir putin


{
    "referenceId": "043c0f6c-c590-448d-8891-ee1f85326580",
    "sanctionsFound": true,
    "details": [
        {
            "name": "vladimir putin",
            "listType": "EU",
            "objectType": "PERSON",
            "reference": "EU.7510.16",
            "nameAliases": [
                "Vladimir Vladimirovich PUTIN",
                "Vladimir Vladimirovitj PUTIN",
                "Vladimir Vladimirovich POUTINE",
                "Влади́мир Влади́мирович ПУ́ТИН"
            ],
            "birthDateAliases": [
                "1952-10-07"
            ],
            "comment": ""
        },
        {
            "name": "vladimir putin",
            "listType": "EU",
            "objectType": "PERSON",
            "reference": "EU.7862.80",
            "nameAliases": [
                "Maria FAASSEN",
                "Mariya VORONTSOVA",
                "Maria Vladimirovna PUTINA",
                "Marija Vladimirovna VORONTSOVA",
                "Maria Vladimirovna VORONTSOVA",
                "Marija Vladimirovna  PUTINA",
                "Marija Vladimirovna VORONCOVA",
                "Marija Vladimirovna PUTINA",
                "Мария Владимировна ВОРОНЦОВА"
            ],
            "birthDateAliases": [
                "1985-04-28"
            ],
            "comment": ""
        },
        {
            "name": "vladimir putin",
            "listType": "EU",
            "objectType": "PERSON",
            "reference": "EU.7872.49",
            "nameAliases": [
                "Katerina Vladimirovna TIKHONOVA",
                "Екатерина Владимировна ТИХОНОВА",
                "Катерина Владимировна ТИХОНОВА",
                "Yekaterina Vladimirovna PUTINA",
                "Yekaterina Vladimirovna TIKHONOVA",
                "Ekaterina Vladimirovna TIKHONOVA",
                "Yekaterina Vladimirovna POETINA",
                "Katerina Vladimirovna TICHONOVA",
                "Jekaterina Vladimirovna TICHONOVA",
                "Jekaterina Vladimirovna TICHONOVOVÁ",
                "Jekatěrina Vladimirovna TICHONOVA"
            ],
            "birthDateAliases": [
                "1986-08-31"
            ],
            "comment": ""
        },
        {
            "name": "vladimir putin",
            "listType": "OFAC-SDN",
            "objectType": "PERSON",
            "reference": "35096",
            "nameAliases": [
                "Putin Vladimir Vladimirovich",
                "Putin Vladimir"
            ],
            "birthDateAliases": [
                "1952-10-07"
            ],
            "comment": "Country: Russia "
        }
    ]
}

Response Example - sanction entiries found for entity: SABTINA


{
    "referenceId": "9a5b060f-4340-42d5-acd5-aa61e63263b8",
    "sanctionsFound": true,
    "details": [
        {
            "name": "sabtina",
            "listType": "EU",
            "objectType": "ENTITY",
            "reference": "EU.3386.81",
            "nameAliases": [
                "Sabtina Ltd"
            ],
            "comment": "Country: UNITED KINGDOM UK-incorporated subsidiary of the Libyan Investment Authority."
        }
    ]
}

Sanction individual person check

Request body

Sanction entity check

Request body

Get latest check related with referenceId

Path parameters

Returns