Get KYC Requirement | Transak

The Get KYC Requirement is an authenticated API call that dynamically returns the KYC status of the User based on the quote ID. Since Transak supports multi-level KYC across different countries, this API helps determine the exact KYC requirements for a user before proceeding with transactions.
The quote ID must be passed when calling this API, as it determines the required KYC level (Simple KYC, Standard KYC, etc.). The response includes the kyc status which can be -

NOT_SUBMITTED → personal and address details are not submitted.
APPROVED → KYC is approved
SUBMITTED → KYC is submitted
ADDITIONAL_FORMS_REQUIRED → Additional KYC information required which can be fetched using GET Additional Requirements API.

The **Get KYC Requirement** is an **authenticated API call** that dynamically returns the **KYC status of the User** based on the **quote ID**. Since Transak supports **multi-level KYC** across different countries, this API helps determine the exact KYC requirements for a user before proceeding with transactions. The **quote ID** must be passed when calling this API, as it determines the required **KYC level (Simple KYC, Standard KYC, etc.)**. The response includes the kyc status which can be - - **NOT_SUBMITTED** → personal and address details are not submitted. - **APPROVED** → KYC is approved - **SUBMITTED** → KYC is submitted - **ADDITIONAL_FORMS_REQUIRED** → Additional KYC information required which can be fetched using GET Additional Requirements API.

Headers

Query parameters

metadata[quoteId]stringRequiredDefaults to YOUR_QUOTE_ID

Quote Id generated from api/v2/lookup/quotes

apiKeystringRequiredDefaults to YOUR_API_KEY

Your API Key from Transak Dashboard

Response

200 - Enhanced KYC Additional Forms Required

dataobject

Errors

400

Bad Request Error

401

Unauthorized Error

500

Internal Server Error

NOT_SUBMITTED → personal and address details are not submitted.
APPROVED → KYC is approved
SUBMITTED → KYC is submitted
ADDITIONAL_FORMS_REQUIRED → Additional KYC information required which can be fetched using GET Additional Requirements API.

1	import requests
2
3	url = "https://api-gateway-stg.transak.com/api/v2/kyc/requirement"
4
5	querystring = {"metadata[quoteId]":"QTE1234567890abcdef","apiKey":"transak_api_key_9876543210abcdef"}
6
7	payload = {}
8	headers = {
9	"authorization": "Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.exampletoken1234567890",
10	"x-user-identifier": "user@example.com",
11	"x-access-token": "partner_access_token_abcdef1234567890",
12	"Content-Type": "application/json"
13	}
14
15	response = requests.get(url, json=payload, headers=headers, params=querystring)
16
17	print(response.json())

1	{
2	"data": {
3	"isAllowedToPlaceOrder": true,
4	"status": "ADDITIONAL_FORMS_REQUIRED",
5	"kycType": "ENHANCED"
6	}
7	}