{ "success": false, "data": null, "error": { "code": "ALREADY_USED", "message": "The identity check behind this link is complete" }, "metadata": { "requestId": "550e8400-e29b-41d4-a716-446655440000", "timestamp": "2026-10-05T10:20:02.000Z" }}
Returns a Sumsub access token for the link’s applicant and level. Pass it to the Sumsub WebSDK or MobileSDK embedded in your own app, and the customer completes the identity check there instead of on verify.trusset.org. See Run the check in your own app.The review that comes back is handled exactly like one from the hosted page. It is accepted only from the level the link was created with, for the applicant type the profile admits, and when no reported country is blocked. See Review rules.The token is valid for expiresInSeconds, 20 minutes. Call again for a fresh one, for example from the SDK’s token expiration handler. Every token is issued for the same applicant, so a customer who stopped halfway continues where they left off.
When a token is issued
Only while the link is open: not revoked or past expiresAt, not rejected, not completed, and with its fee paid. The fee is collected only on the hosted page, so create a link your app runs without feeCents.A review that asks the customer to resubmit leaves a link whose review has not settled open, so a new token lets them resubmit in your app. Once the review has settled, no further token is issued: an approved link answers ALREADY_USED, a refused or rejected one LINK_REJECTED. See A review settles once.The check runs on Trusset’s Sumsub account.
Path Parameters
string
required
The link id, not the token.
Response Fields
object
Show child attributes
string
The Sumsub access token. Pass it to the SDK as is.
integer
1200.
string
The Sumsub level the link was created with. A review from any other level is refused.
string
company when the link’s profile admits companies (entityType: COMPANY), otherwise individual. A review of the other kind of applicant is refused.
curl -X POST "https://api.trusset.org/customers/api/id-links/cmgdx4r2k0003l50a7c1n8e2w/sumsub-token" \ -H "X-API-Key: trusset_your_key_here"