Create a KYC share token

post

https://openapi.advance.ai/v1/individual/reusable_kyc/share_tokens

Call as the donor account to share one of its Profiles with a specified recipient account.
An active donor-to-recipient partnership is required; the reverse partnership does not suffice.

The token is bound to forAccountId and can be successfully consumed once before it expires.
Creating a token does not check the donor Profile's reuse eligibility. The recipient uses
preview or reuse to validate the Profile against its Level.
Treat the returned token as opaque and transmit it securely to the recipient.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Responses

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.

Language

Credentials

Bearer

JWT

Loading…

Response

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

application/json

200Share token created. This does not guarantee that preview or reuse will succeed.

400Invalid request (invalid_request_error), malformed JSON (invalid_json), invalid recipient account (invalid_partner_id), or missing active donor-to-recipient partnership (not_partners).

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

403The calling account is not authorized for the service (permission_error).

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