get https://api.sumsub.com/resources/api/reusableIdentity/reuse/preview
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 code | Error name | Description |
---|---|---|
10501 | not-in-partners-list | Reusing applicants is not allowed since the target is not your partner. |
10502 | invalid-partner-id | The partner ID extracted from the share token is invalid. |
10503 | invalid-share-token | The provided share token is malformed or expired. |
10504 | non-suitable-share-token | The share token is not suitable for reuse with the given level. |
10505 | reusable-kyc-disabled | Reusable KYC functionality is disabled. |
10506 | reusable-kyc-not-reusable | The donor applicant does not meet reuse eligibility criteria. This is a generic fallback error used when a more specific cause is not available. |
10507 | reusable-kyc-not-approved-applicant | The donor applicant is not in an approved state. |
10508 | reusable-kyc-not-active-applicant | The donor applicant is not in an active state. |
10509 | reusable-kyc-not-kyc-moderation-type | The moderation type of the source KYC is not suitable for reuse. |
10510 | reusable-kyc-not-selfie-or-identity-doc | Required selfie or identity document is missing. |
10511 | reusable-kyc-not-selfie-liveness | Liveness is required but not satisfied by the source data. |
10512 | reusable-kyc-not-req-doc-overlap | Required document types do not overlap between source and target levels. |
10513 | reusable-kyc-not-compatible-doc-type | Provided document types are not compatible with target level requirements. |
10514 | reusable-kyc-not-actual-poi-date | Proof of Identity is outdated and not valid for reuse. |
10515 | reusable-kyc-not-actual-poa-date | Proof of Address is outdated and not valid for reuse. |
10516 | reusable-kyc-not-acceptable-age | The applicant does not meet the required age criteria. |
10517 | reusable-kyc-incompatible-capture-settings | Capture settings mismatch between donor and recipient requirements. |