Adds an applicant profile to the blocklist.
Overview
Use this method to blocklist the applicant profile.
Note
Before adding applicants to the blocklist, make sure they are not yet in it by checking for
BLACKLIST
andBLOCKLIST
labels in therejectLabels
array. In case you are trying to add an already listed applicant to blocklist, we will throw the400
HTTP status with the5000
error code.
Did you know?
You can also blocklist applicants from the Dashboard.
Request example
curl -X POST \
'https://api.sumsub.com/resources/applicants/5c0e93c30a975a53a79aa54b/blacklist?note=A%20user%20provided%20a%20fake%20document'
Response explained
The response is a JSON file representing the profile data of the blocklisted applicant with augmented and structured information. You can overview the response structure and possible content with descriptions on the following page.
Mind the review
section of the response to make sure the applicant is blocklisted.
Response example
{
"id": "63e099da46199a0000000000",
"createdAt": "2023-02-06 06:10:34",
"clientId": "yourCoolId",
"inspectionId": "63e099da46199a0000000000",
"externalUserId": "someExternalUserId",
"info": {
"firstName": "John",
"firstNameEn": "John",
"middleName": "",
"middleNameEn": "",
"lastName": "Doe",
"lastNameEn": "Doe"
},
"email": "[email protected]",
"requiredIdDocs": {
"docSets": [
{
"idDocSetType": "IDENTITY",
"types": [
"ID_CARD",
"PASSPORT",
"RESIDENCE_PERMIT",
"DRIVERS"
],
"subTypes": [
"FRONT_SIDE",
"BACK_SIDE"
]
}
]
},
"review": {
"reviewId": "wTgDO",
"attemptId": "hiiOC",
"attemptCnt": 0,
"elapsedSincePendingMs": 3,
"levelName": "basic-kyc-level",
"createDate": "2024-06-17 10:51:01+0000",
"reviewDate": "2024-06-17 10:51:01+0000",
"reviewResult": {
"reviewAnswer": "RED",
"rejectLabels": [
"BLOCKLIST"
],
"reviewRejectType": "FINAL"
},
"reviewStatus": "completed"
},
"type": "individual"
}