Overview

Use this method to retrieve the rejection reasons for a document or applicant. A specific buttonId is automatically assigned to each rejection. For more information, see Temporary rejection clarification and Final rejection clarification.

Response explained

The following table explains the response structure.

Name	Type	Optional	Description
`imagesStates`	Object	Yes	The structure contains `imageId` and `buttonId` indicating the rejection reason.
`applicantState`	Object	Yes	The structure contains `buttonId` indicating the rejection reason of the applicant data or applicant.

📘
Note
imagesStates and applicantState are present in the response only when the applicant is rejected.

Temporary rejection clarification

Rejection reason:

Button	buttonID	Rejection label	Description
Screenshots	screenshot	SCREENSHOTS, UNSATISFACTORY_PHOTOS	The applicant uploaded screenshots instead of photos or scans.
Black and white	blackAndWhite	BLACK_AND_WHITE, UNSATISFACTORY_PHOTOS	The applicant uploaded black and white photos of a document instead of color photos.
Edited PoA	editedPoa	GRAPHIC_EDITOR, UNSATISFACTORY_PHOTOS	The uploaded photo displays signs of tampering via a digital editor.
Data not readable	dataNotVisible	UNSATISFACTORY_PHOTOS	The information on the uploaded photo is illegible. The image may be blurred or cropped, making it impossible to read the needed data (for example name or MRZ).
Sticker	sticker	GRAPHIC_EDITOR, UNSATISFACTORY_PHOTOS	The uploaded photo displays signs of tampering via a digital editor.
Incomplete document	incomplete	INCOMPLETE_DOCUMENT, UNSATISFACTORY_PHOTOS	Part of the document (document corners) is not visible.
Photoshop	imageEditor	GRAPHIC_EDITOR, UNSATISFACTORY_PHOTOS	The photo displays signs of tampering via a digital editor. The purpose of the editor could be anything from resizing to forgery.
Main page of the document	mainPageId	DOCUMENT_PAGE_MISSING	The uploaded document is missing the biodata page.
Address page	registrationStamp	DOCUMENT_PAGE_MISSING	The uploaded document is missing the address page.
Expiration date page	expirationPage	DOCUMENT_PAGE_MISSING	The uploaded document is missing the expiration date page.
Next page	nextPage	DOCUMENT_PAGE_MISSING	The uploaded document is missing a page.
Another side	anotherSide	DOCUMENT_PAGE_MISSING	The uploaded document is double-sided and only one side was uploaded.

Button	buttonID	Rejection label	Description
Full name issue	fullName	PROBLEMATIC_APPLICANT_DATA	The full name in the profile does not match the name in the document uploaded by the applicant.
Date of birth issue	dateOfBirth	PROBLEMATIC_APPLICANT_DATA	The date of birth in the profile does not match the date of birth in the document uploaded by the applicant.
Gender mismatch	gender	PROBLEMATIC_APPLICANT_DATA	The gender in the applicant profile does not match the gender in the document uploaded by the applicant.
Address issue	address	WRONG_ADDRESS	The address in the profile does not match the address in the document uploaded by the applicant.
Incorrect TIN	incorrectTin	INCORRECT_SOCIAL_NUMBER	The tax number provided by the applicant is incorrect.
Incorrect SSN	incorrectSsn	INCORRECT_SOCIAL_NUMBER	The SSN number provided by the applicant is incorrect.
Incorrect BVN	incorrectBvn	INCORRECT_SOCIAL_NUMBER	The BVN number provided by the applicant is incorrect.

Button	buttonID	Rejection label	Description
Low quality of ID	lowQuality	BAD_SELFIE	The information on the ID document is not visible or can not be read.
Selfie with ID	selfieWithId	BAD_SELFIE	The applicant uploaded a selfie without the ID document.
Selfie with another ID	selfieWithAnotherId	BAD_SELFIE	The ID document in the selfie is different from the ID document uploaded by the applicant.
Selfie with new ID	selfieWithNewId	BAD_SELFIE	The ID document in the selfie can not be detected or read.
Compare with ID mismatch	badFaceComparison	BAD_FACE_MATCHING, BAD_SELFIE	The applicant's face on the selfie is not clearly visible and can not be matched against the photo in the ID document.
Webcam selfie	webcamSelfie	BAD_SELFIE	The applicant failed the Liveness check.
Liveness with watermark	livenessWatermark	BAD_SELFIE	There is camera text or a watermark on the Liveness record originating from the proprietary software.
Selfie Liveness	selfieLiveness	BAD_SELFIE	The applicant failed the Liveness check.
Spoken phrase mismatch	videoWithoutFace	BAD_VIDEO_SELFIE	The pronounced phrase does not match the provided text.
Video without face	spokenPhraseMismatch	BAD_VIDEO_SELFIE	The applicant's face can not be detected on the selfie.

Button	buttonID	Rejection label	Description
Interrupted interview	applicantInterruptedInterview	APPLICANT_INTERRUPTED_INTERVIEW	On the Video Ident call, the applicant did not finish the interview.
No docs	noSuitableDocs	DOCUMENT_MISSING	The applicant failed to provide the required documents on the Video Ident call.
Not alone	notAlone	UNSUITABLE_ENV	On the Video Ident call, the applicant was not alone.
Applicant can not be seen	notSeen	UNSUITABLE_ENV	On the Video Ident call, the applicant was not visible.
Bad connection	badConnection	CONNECTION_INTERRUPTED	The Video Ident call connection was interrupted.

Button	buttonID	Rejection label	Description
Invalid ID	invalidId	ID_INVALID	The provided identity document is invalid.
Expired ID	expiredId	EXPIRATION_DATE	The provided identity document has expired.
ID expiration date (1 month)	expirationDate	EXPIRATION_DATE	The provided identity document expires in less than one month.
Damaged ID	damagedId	DOCUMENT_DAMAGED	The provided ID document is damaged to the extent that it makes verification data, such as name or MRZ, unreadable (e.g. the ID is stained or scratched).
Without face	withoutFace	BAD_PROOF_OF_IDENTITY	The face of the document’s owner is poorly visible, making face match impossible.
No full name or DoB	notFullNameOrDob	BAD_PROOF_OF_IDENTITY	Applicant full name or date of birth is not present in the provided document.
English translation	needTranslation	INCOMPATIBLE_LANGUAGE	The applicant uploaded a document in a language that is not supported by Sumsub, so the notarized English translation has been requested.
Copy of ID doc	copyOfIdDoc	BAD_PROOF_OF_IDENTITY	The applicant has uploaded a photo of a paper copy of their document instead of the original document, which is no acceptable.
No stamp	noStamp	BAD_PROOF_OF_IDENTITY	The applicant uploaded a document that does not have the stamp of the issuing organization.
Unsigned document	unsigned	BAD_PROOF_OF_IDENTITY	The applicant uploaded a document without relevant signatures and stamps.
Wrong type	wrongType	BAD_PROOF_OF_IDENTITY	The uploaded document can not be accepted for verification.

Button	buttonID	Rejection label	Description
List of documents	listOfDocs	BAD_PROOF_OF_ADDRESS	The applicant uploaded a document that is not supported by Sumsub.
Full name	fullName	BAD_PROOF_OF_ADDRESS	The full name of the applicant has not been provided on the document or can’t be read.
Full address	fullAddress	BAD_PROOF_OF_ADDRESS	The full address of the applicant has not been provided on the document or can’t be read.
Issue date	issueDate	BAD_PROOF_OF_ADDRESS	There is no issue date on the document uploaded by the applicant.
Passport without number	notEnoughData	BAD_PROOF_OF_ADDRESS	There is no number on the document (passport) uploaded by the applicant.
Certified form	certifiedForm	BAD_PROOF_OF_ADDRESS	There is no stamp/signature of the issuing organization on the document uploaded by the applicant.
Submit the same document	sameDoc	BAD_PROOF_OF_ADDRESS	The applicant uploaded the same document as PoA and PoI.
Applicant data mismatch	dataMismatch	BAD_PROOF_OF_ADDRESS	The address on the document uploaded by the applicant does not match the address entered by the applicant.

Button	buttonID	Rejection label	Description
Black crypto	blackCrypto	BAD_PROOF_OF_PAYMENT	The crypto wallet address is incorrect.
Bank card	bankCard	BAD_PROOF_OF_PAYMENT	The information on the bank card is missing or can’t be read.
Bank statement	bankStatement	BAD_PROOF_OF_PAYMENT	The information on the bank statement is missing or can’t be read.
Bank account	bankAccount	BAD_PROOF_OF_PAYMENT	The information about the bank account is missing.
E-wallet	e-wallet	BAD_PROOF_OF_PAYMENT	The e-wallet needs to be confirmed.
Wire transfer	wireTransfer	BAD_PROOF_OF_PAYMENT	The wire transfer needs to be confirmed.
Bank card without name	fullNameIssue	BAD_PROOF_OF_PAYMENT	The name on the bank card is missing.
Expired bank card	expirationDate	BAD_PROOF_OF_PAYMENT	The provided bank card has expired or expires soon.
Copy bank card	noCard	BAD_PROOF_OF_PAYMENT	The applicant uploaded an image of a copy of the bank card.
Full name (bank statement)	fullNameIssue	BAD_PROOF_OF_PAYMENT	The full name on the bank statement is missing or can not be read.
Account/Card number	notEnoughData	BAD_PROOF_OF_PAYMENT	The account/card number on the bank statement is missing or can not be read.
Issue date (bank statement)	invalidIssueDate	BAD_PROOF_OF_PAYMENT	The issue date on the bank statement is missing or can not be read.
Card number mismatch	numberMismatch	BAD_PROOF_OF_PAYMENT	The bank card number on the bank statement does not match the provided bank card.
Decline payment	proofOfPayment	BAD_PROOF_OF_PAYMENT	N/A

Button	buttonID	Rejection label	Description
Control structure is not established	controlStructureIsNotEstablished	COMPANY_NOT_DEFINED_STRUCTURE	Sumsub could not establish the verified entity's control structure.
Beneficiaries are not defined	notDeteminedBeneficiares	COMPANY_NOT_DEFINED_BENEFICIARIES	Sumsub could not identify or properly verify the verified entity's beneficial owners.
Beneficiaries are not validated	notValidatedBeneficiares	COMPANY_NOT_VALIDATED_BENEFICIARIES	Sumsub could not validate the verified entity's beneficial owners.
Representatives are not defined	notDeterminedRepresentatives	COMPANY_NOT_DEFINED_REPRESENTATIVES	Sumsub could not validate the verified entity's representatives.
Representatives are not validated	notValidatedRepresentatives	COMPANY_NOT_VALIDATED_REPRESENTATIVES	Sumsub could not identify or properly verify the verified entity's representatives.
More docs	moreDocs	ADDITIONAL_DOCUMENT_REQUIRED	Sumsub needs more documents to process with verification.

Button	buttonID	Rejection label	Description
Check unavailable	checkUnavailable	CHECK_UNAVAILABLE	The government database is currently unavailable, so we were not able to verify applicant data.

Final rejection clarification

Rejection reason:

Button	buttonID	Associated rejection label	Description
Edited MRZ	editedMrz	FORGERY	MRZ of the document was modified.
Edited ID data	editedId	FORGERY	Data in the document was modified.
Edited barcode	editedBarcode	FORGERY	The barcode in the document was modified.
Physical forgery	forgedId	FORGERY	The document has been physically tampered with.
Image from the web	webId	FORGERY	The photo of the document was found on the dark web.
Fake PoA	fakePoa	FORGERY	The information in the PoA document is inconsistent.
Fake Liveness	fakeLiveness	FORGERY	An attempt to bypass the liveness check was detected.
Selfie with fake ID	fakeSelfie	FORGERY	The ID document used in the selfie is fake.
Fake	fake	FORGERY	We suspect the applicant account is fradulent.
Deepfake	deepFake	FORGERY	A deepfake attempt detected.
NFC data mismatch	nfcMismatch	FORGERY	The data extracted form the NFC chip does not match the data in the document.
Forced Verification	forcedVerification	FORGERY	We suspect the applicant was forced to pass verification.
Liveness with phone	livenessWithPhone	FORGERY	The applicant phone was present during the livdeness check.
Fake (payments)	fraudulentPatterns	FORGERY	We suspect the applicant account is fradulent.
Template	template	FORGERY	We suspect tampered data.

Button	buttonID	Associated rejection label	Description
Selfie mismatch	selfieMismatch	SELFIE_MISMATCH	The applicant’s selfie does not match the photo in the document.
Red crypto	redCrypto	BAD_PROOF_OF_PAYMENT	The provided e-wallet has a high risk score.
High-risk profile	highRiskProfile	FRAUDULENT_PATTERNS	The system has detected suspicious applicant behavior such as high-risk IP, using multiple devices, etc.
Different bank cards	differentDocs	INCONSISTENT_PROFILE, BAD_PROOF_OF_PAYMENT	The bank cards submitted by the applicant belong to different people.
Different people	livenessDifferentPeople	FRAUDULENT_LIVENESS	Multiple people/devices were present during the liveness check.
Bypass attempts	livenessBypass	FRAUDULENT_LIVENESS	The applicant attempted to use digital and/or physical objects to fool the system.
Different docs	differentDocs	INCONSISTENT_PROFILE	The documents or means of payment submitted by the applicant belong to different people.
Printed copy of ID	printedIdCopy	NOT_DOCUMENT	The document uploaded by the applicant is a printout.
Blocklist	blocklist	BLACKLIST	We suspect the applicant account is fradulent, as it has a very high risk score.
Countries mismatch	countriesMismatch	REGULATIONS_VIOLATIONS, BAD_PROOF_OF_PAYMENT	The applicant country of residence does not match the bank card registration country.
High-risk bank card	riskBankCard	REGULATIONS_VIOLATIONS, BAD_PROOF_OF_PAYMENT	The provided bank card has a high risk score.
Name mismatch	inconsistency	REGULATIONS_VIOLATIONS, BAD_PROOF_OF_PAYMENT	The bank card holder name does not match the name on the applicant ID.
Different bank cards (payments)	differentDocs	REGULATIONS_VIOLATIONS, BAD_PROOF_OF_PAYMENT	The submitted bank cards belong to different people.
3rd Force Involvement	forcedVerification	FRAUDULENT_PATTERNS	The video ident call showed that the applicant was misled and/or forced by the 3rd party to create the account.
Sponsored registration	3rdPartyInvolvement	THIRD_PARTY_INVOLVED	We suspect the applicant was paid to create the account.
Rejected payment	paymentsIssues	BAD_PROOF_OF_PAYMENT	The provided payment method was rejected due to high risk.

Button	buttonID	Associated rejection label	Description
Age	age	AGE_REQUIREMENT_MISMATCH, REGULATIONS_VIOLATIONS	The applicant does not meet the client's age requirements.
Wrong region	wrongRegion	WRONG_USER_REGION, REGULATIONS_VIOLATIONS	The applicant is from a region or a country that is not supported by the client.
Duplicate	duplicate	DUPLICATE, REGULATIONS_VIOLATIONS	By default, one applicant can have only one active account.
Spam	spam	SPAM	The applicant uploaded irrelevant images or failed to provide the required documents 6 or more times.
Unsupported language	unsupportedLanguage	UNSUPPORTED_LANGUAGE	The applicant doesn't speak any of the supported languages.

Button	buttonID	Associated rejection label	Description
Not enough data in source	notEnoughDataInSource	PROBLEMATIC_APPLICANT_DATA	Sumsub could not find the applicant data in the government database.
E-KYC skipped	skip	PROBLEMATIC_APPLICANT_DATA	E-KYC step has been skipped.
Data mismatch	dataMismatch	PROBLEMATIC_APPLICANT_DATA	The data provided by the applicant does not match the data from the government database.

Button	buttonID	Associated rejection label	Description
Sanctions	sanctionList	SANCTIONS	The applicant was mentioned on sanctions lists.
PEP	pep	PEP	The applicant is a politically exposed person. This means that they are currently in a position of great control or have been in the past.
Criminal records	criminalRecords	CRIMINAL	The applicant is a convicted criminal.
Adverse media	adverseMedia	ADVERSE_MEDIA	The applicant is mentioned in adverse media.
Incomplete data	incompleteName	COMPROMISED_PERSONS	The name the applicant entered is incomplete, so the system could not match it against the watchlists properly.

JSON representation

The following is a JSON representation containing the list of button identifiers and their associated groups.

📘
Info
The method returns a combination of group identifiers and button identifiers. For example, dataMismatch_fullName.

{
  "spam":[], 
  "redCrypto":[], 
  "blackCrypto":[], 
  "differentDocs":[], 
  "paymentsIssues":[], 
  "regulationsViolations":[
     "age", 
     "duplicate", 
     "wrongRegion", 
     "inconsistency", 
     "docNotFound", 
     "countriesMismatch", 
     "riskBankCard", 
     "spam", 
     "blocklist", 
     "highRiskProfile", 
     "gender", 
     "unsupportedLanguage" 
  ],
  "dataMismatch":[
     "fullName", 
     "dateOfBirth", 
     "address", 
     "inconsistency", 
     "gender" 
  ],
  "fraudulentPatterns":[
    "selfieMismatch", 
    "fake", 
    "blocklist", 
    "highRiskProfile", 
    "physicalForgery", 
    "wantedDocument", 
    "livenessForced", 
    "deepFake",
    "template"
  ],
  "dbNetChecks":[
     "incorrectTin", 
     "incorrectSsn", 
     "incorrectBvn" 
  ],
  "compromisedPersons":[
     "pep", 
     "sanctionList", 
     "criminalRecords", 
     "incompleteName", 
     "adverseMedia" 
  ],
  "company":[
     "moreDocs", 
     "controlStructureIsNotEstablished", 
     "notValidatedBeneficiaries", 
     "notDeterminedRepresentatives", 
     "notValidatedRepresentatives" 
  ],
  "additionalPages":[
     "mainPageId", 
     "nextPage", 
     "registrationStamp", 
     "expirationPage", 
     "proofOfAddress",
     "anotherSide" 
  ],
  "badDocument":[
     "expiredId", 
     "invalidId", 
     "damagedId", 
     "wrongType", 
     "notFullNameOrDob", 
     "withoutFace", 
     "dataNotVisible", 
     "copyOfIdDoc", 
     "noStamp", 
     "unsigned", 
     "needTranslation", 
     "fake", 
     "expirationDate", 
     "inconsistency" 
  ],
  "badPhoto":[
     "lowQuality", 
     "editedPoa", 
     "screenshot", 
     "blackAndWhite", 
     "imageEditor", 
     "incomplete", 
     "dataNotVisible", 
     "sticker" 
  ],
  "selfie":[
     "lowQuality", 
     "selfieWithId", 
     "webcamSelfie", 
     "selfieWithAnotherId", 
     "selfieWithNewId", 
     "blackAndWhite", 
     "badFaceComparison", 
     "selfieLiveness", 
     "livenessWatermark" 
  ],
  "videoSelfie":[
     "lowQuality", 
     "videoWithoutFace", 
     "spokenPhraseMismatch" 
  ],
  "proofOfAddress":[
     "fullName", 
     "fullAddress", 
     "issueDate", 
     "listOfDocs", 
     "expirationDate", 
     "dataMismatch", 
     "sameDoc", 
     "certifiedForm", 
     "notEnoughData" 
  ],
  "proofOfPayment":[
     "bankCard", 
     "bankStatement", 
     "e-wallet", 
     "wireTransfer", 
     "bankAccount", 
     "dataMismatch" 
  ],
  "bankCard":[
     "fullNameIssue", 
     "expirationDate", 
     "noCard" 
  ],
  "bankStatement":[
     "fullNameIssue", 
     "numberMismatch", 
     "invalidIssueDate", 
     "notEnoughData" 
  ],
  "fake":[
     "editedMrz", 
     "editedId", 
     "forgedId", 
     "webId", 
     "fakePoa", 
     "editedBarcode", 
     "fakeLiveness", 
     "fakeSelfie", 
     "nfcMismatch" 
  ],
  "selfieIssues":[
     "livenessWithPhone", 
     "livenessDifferentPeople" 
  ],
  "videoIdent":[
     "notAlone", 
     "badConnection", 
     "notSeen", 
     "noSuitableDocs", 
     "applicantInterruptedInterview" 
  ],
  "videoIdentFinalRejection":[
     "unsupportedLanguage", 
     "3rdPartyInvolvement", 
     "forcedVerification" 
  ],
  "ekycReject":[
     "notEnoughDataInSource", 
     "skip", 
     "dataMismatch" 
  ],
  "ekycRetry":[
     "checkUnavailable" 
  ]
}

Overview

Response explained

Temporary rejection clarification

Button

buttonID

Rejection label

Description

Button

buttonID

Rejection label

Description

Button

buttonID

Rejection label

Description

Button

buttonID

Rejection label

Description

Button

buttonID

Rejection label

Description

Button

buttonID

Rejection label

Description

Button

buttonID

Rejection label

Description

Button

buttonID

Rejection label

Description

Button

buttonID

Rejection label

Description

Final rejection clarification

Button

buttonID

Associated rejection label

Description

Button

buttonID

Associated rejection label

Description

Button

buttonID

Associated rejection label

Description

Button

buttonID

Associated rejection label

Description

Button

buttonID

Associated rejection label

Description

JSON representation