Identity details

View as Markdown
Submits the user's **personal details**, **address**, **purpose of usage**, and optional **tax identifier (TIN)** data to initialize the KYC Reliance flow. **This request must always be called first** in the KYC Reliance sequence—it initializes the KYC request on Transak's side.

Headers

x-access-tokenstringOptional

Your Partner Access Token. Please refer here for a tutorial on generating your access token.

Note: This is applicable only for Auth Reliance Flows

x-user-identifierstringOptional

our authenticated user Email Id address.

Note: This is applicable only for Auth Reliance Flows

authorizationstringOptional

Authorization token is the accessToken received from the API - api/v2/auth/verify

Note: This is not applicable for Auth Reliance Flows

Request

This endpoint expects an object.
personalDetailsobjectRequired
addressDetailsobjectRequired
purposeListlist of stringsRequired

Supported purpose strings (same contract as existing Whitelabel purpose-of-usage values). Examples include "Buying/selling crypto for investments", "Buying NFTs", and "Buying crypto to use a web3 protocol".

tinDetailsobjectOptional

Tax identification details. Optional depending on country/regulatory requirements — required when TIN collection applies for the user’s jurisdiction.

Response

Success — KYC request initialized

dataobject

Errors

400
Bad Request Error
401
Unauthorized Error