TRANSAK WHITELABEL APIKYC Reliance

Get KYC Reliance Status

View as Markdown
The **Get KYC Reliance Status** is an **authenticated API call** that validates the KYC Shared token from SumSub by providing the appropriate status. This API is mandatory in the KYC Reliance process to sync the KYC details from the Partner system to Transak. Below is the status that explains the various KYC Reliance statuses in detail. ### KYC Reliance Status Types | **State** | **Description** | | --- | --- | | **IMPORTED** | Triggered when **KYC Reliance data** is successfully fetched, but not successfully processed from Transak. Use **Get KYC Steps** API to process or find the missing details. | | **DONE** | Final state indicating the **KYC Reliance process is completed** successfully (WHEN forms\[\] is empty, meaning there are no pending or missing KYC details) | | **FAILED** | Indicates the **KYC Reliance process has failed** due to validation or processing errors. The partner has to redo the KYC token generation process by providing the required details. <br> <br>Note: Use **Get KYC Steps** to find the missing details. | | **INITIALIZED** | Indicates that the Transak system received the KYC share token. This is the initial status field that can be triggered only when the KYC share token is passed in the **Get KYC Reliance Quote** API. <br> <br>Note: This status will barely be noticed as it is an interim state before **IMPORTED**. | | **VALIDATED** | This intermediate status between **IMPORTED** and **DONE** means that the Transak system validates the fields. | > Note: In an ideal scenario, only **IMPORTED**, **DONE** and **FAILED** are primarily used.

Headers

authorizationstringRequired

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

Note: This is not applicable for Auth Reliance Flows

x-user-identifierstringOptional

Your authenticated user Email Id address.

Note: This is applicable only for Auth Reliance Flows

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

Query parameters

quoteIdstringRequired
Quote ID received from the Get KYC Reliance Quote API.
kycShareTokenProviderstringRequired

KYC provider used to generate the share token (for example, SUMSUB).

kycShareTokenstringRequired
KYC share token generated by the selected provider.

Response

200 - Successfully Imported

dataobject

Errors

400
Bad Request Error
401
Unauthorized Error
404
Not Found Error
500
Internal Server Error