Skip to main content
POST
Generate Individual KYC Link
Generates a hosted identity verification link for an individual account — the individual-flow parallel of the related-person KYC link. Share the returned URL with the account holder: 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 and Get Verification Status.
This endpoint is only for individual accounts. For a business account’s owners and directors, use the related-person KYC link instead — calling this on a business account returns 400.
Already verify identity in your own onboarding? Submit KYC Reliance lets you upload the passport and liveness capture you collected instead of sending the account holder through this hosted flow. It is enabled per partner.

Example Request

Example Response

For white-label tenants, the url is returned on your branded subdomain (e.g. https://yourbrand.rolla.xyz/en/kyc/individual/...), so your customers stay on-brand throughout verification.

Key Behaviours

Links expire after 72 hours. Generating a new link for the same account invalidates the previous one.
The link status becomes completed once the account holder passes verification, or rejected if it fails.After a failure, generate a fresh link and the previous failed attempt is cleared for you, so the account holder can try again. You do not need to contact Rolla. A link already marked rejected never becomes usable again — always send the customer the new one. An account that 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 individual account owned by the same user as your API key's business

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