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).

The check is performed synchronously - the POST endpoints return the check result in the same format as the GET endpoint.

Status codes for both check endpoints: 200 - check performed, the response contains the result; 400 - validation error (e.g. “Name is required”, “Surname is required”, “Entity name is required”); 500 - the check could not be performed, the response contains referenceId and error: “Failed to perform sanction list check”.

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, max 255 characters. It is scoped to your account and can be reused - GET returns the latest check. 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 - 400, 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

Entity (company or organization) name

▸referenceIdstringOptional

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. Returns 404 when there is no check with the given referenceId or the check failed.

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 (lowercase, name and surname separated by a space for a person).

▸listTypestringOptional

Type of list where match was found

▸referencestringOptional

Reference number of the entry on the sanctions list

▸objectTypeenum PERSON|ENTITYOptional

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


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

Response Example - 404, no result found or the check failed


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

Response Example - sanction entries 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 entries 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