Check KYC reuse eligibility

post

https://openapi.advance.ai/v1/individual/reusable_kyc/reuse/preview

Call as the recipient account to validate the sharing token, partnership, product access,
recipient Level, and donor Profile eligibility. Uses the same eligibility checks as reuse.

Preview does not create or update a Profile, charge for reuse, or consume the token.
Success is HTTP 200 with an empty response body. It does not reserve the token or guarantee
a later reuse: the token can expire or be consumed, and Profile or configuration state can change.
externalUserId is accepted for request parity but is not used to validate the target Profile.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Responses

200

Eligibility checks passed. Empty response body; do not attempt to parse JSON.

error.type	Meaning
invalid_request_error	Missing, blank, or invalid request field.
invalid_json	Request body is not valid JSON.
invalid_share_token	Token is invalid, expired, already consumed, or issued for another recipient.
invalid_partner_id	Invalid donor account identity.
not_partners	No active donor-to-recipient partnership.
recipient_level_not_suitable	Recipient Level cannot be resolved or used for reuse; requires Document and/or Face and no AML step.
profile_not_active	Donor Profile is unavailable or not ACTIVE.
profile_no_verifiedinfo	Donor Profile has no recorded verification Level.
not_identity_doc	Recipient requires Document but the donor has no identity document.
not_selfie_liveness	Recipient requires Face but the donor has no SELFIE record.
country_not_suitable	Donor documents do not cover a required country.
doc_type_not_suitable	Donor documents do not cover a required document type.
doc_side_not_suitable	A required two-sided document has fewer than two file entries.
age_not_acceptable	Document identity does not meet the configured age policy.
doc_expired	Document fails expiration or remaining-validity policy.
nationality_not_acceptable	Document identity does not meet the configured nationality policy.
reusable_kyc_not_reusable	Other eligibility failure, including missing inputs for an enabled compliance check.

error.type	Meaning	Action
insufficient_balance	Account balance is insufficient.	Top up the account balance.
test_quota_exceeded	Account test quota is exceeded.	Contact your account manager.

error.type	Meaning
permission_error	The calling account is not authorized for the service.
reusable_kyc_disabled	Reusable KYC is not enabled for the recipient.
insufficient_balance_error	The recipient failed the Reusable KYC product balance check.
over_query_limit_error	The recipient failed the Reusable KYC product quota check.

Language

Credentials

Bearer

JWT

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

401Missing or invalid authentication. Use the donor credentials for share-token creation and the recipient credentials for preview and reuse.

500Unexpected service failure (internal_error). A failed reuse response does not prove that no Profile changes occurred. Reconcile the recipient Profile before retrying.