--- updatedAt: 2026-09-29T07:37:53.000Z agentTools: projectIndex: https://docs.sumsub.com/llms.txt --- # 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](https://docs.sumsub.com/sumsub/reference/reuse-applicant-for-reusable-kyc), but without initiating the reuse process. No data is copied or saved—only validation logic is executed. ## Required permissions To use this method, your [app token](https://docs.sumsub.com/sumsub/docs/app-tokens) must have the **Create applicants** [permission](https://docs.sumsub.com/sumsub/docs/user-roles#permissions). ## Request example ```curl curl -X POST \ 'https://api.sumsub.com/resources/api/reusableIdentity/reuse/preview?shareToken=_act-jwt-lokijuhygtJub25lIn0.eyJqdGkiOiJfYWN0LTE3YjM5YTljLWRhOWUtNGY2MS04Y2ZjLTYwNzViNWM2NDk5MSIsInVybCI6Imh0dHA6Ly9sb2NhbGhvc3Q6ODA5MCJ9.&levelName=liveness-id-poa' \ -H 'X-App-Token: ' \ -H 'X-App-Access-Sig: ' \ -H 'X-App-Access-Ts: ' ``` ## 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. | | 10518 | `reusable-kyc-email-mismatch` | Email is potentially reusable but does not match the existing email on the recipient side. | | 10519 | `reusable-kyc-phone-mismatch` | Phone number is potentially reusable but does not match the existing phone number on the recipient side. | | 10521 | `reusable-kyc-inactive-sumsub-id-account` | The donor Sumsub ID account does not have any stored documents for reuse. | | 10525 | `reusable-kyc-unsuitable-questionnaire` | Provided questionnaire is not compatible with target level requirements. |
# OpenAPI definition ```json { "openapi": "3.1.0", "info": { "title": "sumsub-api", "version": "1.0" }, "servers": [ { "url": "https://api.sumsub.com" } ], "components": { "securitySchemes": { "sec0": { "type": "apiKey", "name": "X-App-Token", "in": "header", "x-default": "" } } }, "security": [ { "sec0": [] } ], "paths": { "/resources/api/reusableIdentity/reuse/preview": { "get": { "summary": "Simulate reusing applicant for Reusable KYC", "description": "", "operationId": "simulate-reusing-applicant-for-reusable-kyc", "parameters": [ { "name": "shareToken", "in": "query", "description": "A token used to access the shared KYC data, received from your partner.

You can generate a share token for your partners using the following method.", "required": true, "schema": { "type": "string" } }, { "name": "levelName", "in": "query", "description": "The name of the level on the recipient's side for which the KYC data is being reused.", "required": true, "schema": { "type": "string" } }, { "name": "userId", "in": "query", "description": "Sets your own `externalUserId` for the applicant. In case of an empty value, we will generate a random one.", "schema": { "type": "string" } }, { "in": "query", "name": "sourceKey", "schema": { "type": "string" }, "description": "One of the source keys available on the recipient side.
Passing an unknown value will return a validation error: `Source key 'key_name' is not allowed for license key cross`." } ] } } }, "x-readme": { "headers": [], "explorer-enabled": true, "proxy-enabled": true }, "x-readme-fauxas": true } ```