Skip to main content
POST
Generate KYC Link
Generates a hosted identity verification link for a related person. Share the link with the person — it opens a Rolla-hosted page where they upload an ID document and complete a liveness check. Their verification status is reflected in Get Requirements.
Already verify these people in your own onboarding? Submit Representative KYC Reliance lets you upload the passport and liveness capture you collected instead of sending them through this hosted flow. It is enabled per partner, and can be mixed with hosted links across the same account.

Example Request

Example Response

Key Behaviours

Links expire after 72 hours. Generating a new link for the same person invalidates the previous one.
The link status becomes completed once the person passes verification, or rejected if it fails.After a failure, generate a fresh link and the previous failed attempt is cleared for you, so that person can try again. You do not need to contact Rolla. A link already marked rejected never becomes usable again — always send them the new one. A person who has already passed is left untouched: generating a link never discards a good verification.

Authorizations

X-API-Key
string
header
required

Your Rolla API key

Path Parameters

accountId
string<uuid>
required

Identifier of an account owned by the same user as your API key's business

personId
string<uuid>
required

Related person identifier, as returned by Add Related Person

Response

KYC link generated successfully

status
integer
required
Example:

201

message
string
required
Example:

"KYC link generated successfully"

success
boolean
required
Example:

true

data
object
required