Simulate reusing applicant for Reusable KYC

Overview

Use this method to preview the reuse of an applicant for Reusable KYC. It performs the same validations as the reuse endpoint, but without initiating the reuse process.

No data is copied or saved—only validation logic is executed.

Request example

 curl -X POST \
    'https://api.sumsub.com/resources/api/reusableIdentity/reuse/preview?shareToken=_act-jwt-eyJhbGciOiJub25lIn0.eyJqdGkiOiJfYWN0LTE3YjM5YTljLWRhOWUtNGY2MS04Y2ZjLTYwNzViNWM2NDk5MSIsInVybCI6Imh0dHA6Ly9sb2NhbGhvc3Q6ODA5MCJ9.&levelName=liveness-id-poa'

Possible errors

Both reuse method and this endpoint may return a set of predefined error responses when the reuse operation is not allowed or the input is invalid.

Below is a list of possible errors and their descriptions:

Error codeError nameDescription
10501not-in-partners-listReusing applicants is not allowed since the target is not your partner.
10502invalid-partner-idThe partner ID extracted from the share token is invalid.
10503invalid-share-tokenThe provided share token is malformed or expired.
10504non-suitable-share-tokenThe share token is not suitable for reuse with the given level.
10505reusable-kyc-disabledReusable KYC functionality is disabled.
10506reusable-kyc-not-reusableThe donor applicant does not meet reuse eligibility criteria. This is a generic fallback error used when a more specific cause is not available.
10507reusable-kyc-not-approved-applicantThe donor applicant is not in an approved state.
10508reusable-kyc-not-active-applicantThe donor applicant is not in an active state.
10509reusable-kyc-not-kyc-moderation-typeThe moderation type of the source KYC is not suitable for reuse.
10510reusable-kyc-not-selfie-or-identity-docRequired selfie or identity document is missing.
10511reusable-kyc-not-selfie-livenessLiveness is required but not satisfied by the source data.
10512reusable-kyc-not-req-doc-overlapRequired document types do not overlap between source and target levels.
10513reusable-kyc-not-compatible-doc-typeProvided document types are not compatible with target level requirements.
10514reusable-kyc-not-actual-poi-dateProof of Identity is outdated and not valid for reuse.
10515reusable-kyc-not-actual-poa-dateProof of Address is outdated and not valid for reuse.
10516reusable-kyc-not-acceptable-ageThe applicant does not meet the required age criteria.
10517reusable-kyc-incompatible-capture-settingsCapture settings mismatch between donor and recipient requirements.
Language
Credentials
Header
Click Try It! to start a request and see the response here!