> For a complete page index, fetch https://docs.transak.com/llms.txt # Identity details POST https://api-gateway-stg.transak.com/kyc/v2/reliance/identity-details Content-Type: application/json 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. Reference: https://docs.transak.com/api/whitelabel/kyc-reliance-api/kyc-reliance-identity-details ## OpenAPI Specification ```yaml openapi: 3.1.0 info: title: whitelabel-api version: 1.0.0 paths: /kyc/v2/reliance/identity-details: post: operationId: kyc-reliance-identity-details summary: Identity details description: >- 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. tags: - subpackage_kycRelianceApi parameters: - name: x-access-token in: header description: >- Your Partner Access Token. Please refer [here](/guides/how-to-create-partner-access-token) for a tutorial on generating your access token. Note: This is applicable only for [Auth Reliance Flows](/features/auth-reliance) required: false schema: type: string - name: x-user-identifier in: header description: >- our authenticated user Email Id address. Note: This is applicable only for [Auth Reliance Flows](/features/auth-reliance) required: false schema: type: string - name: authorization in: header description: >- Authorization token is the accessToken received from the API -` api/v2/auth/verify` Note: This is not applicable for [Auth Reliance Flows](/features/auth-reliance) required: false schema: type: string responses: '200': description: Success — KYC request initialized content: application/json: schema: $ref: '#/components/schemas/KycRelianceSuccessResponse' '400': description: Bad Request — validation or processing failure content: application/json: schema: $ref: >- #/components/schemas/Kyc-reliance-identity-detailsRequestBadRequestError '401': description: Unauthorized — invalid token or user not onboarded content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' requestBody: content: application/json: schema: $ref: '#/components/schemas/IdentityDetailsRequest' servers: - url: https://api-gateway-stg.transak.com components: schemas: PersonalDetails: type: object properties: firstName: type: string description: First name of the user. lastName: type: string description: Last name of the user. dob: type: string format: date description: Date of birth in `YYYY-MM-DD` format. mobileNumber: type: string description: >- Mobile number of the user (E.164 or locale-specific format as accepted by the API). required: - firstName - lastName - dob - mobileNumber title: PersonalDetails AddressDetails: type: object properties: addressLine1: type: string addressLine2: type: string description: Optional second address line. state: type: string city: type: string countryCode: type: string description: >- Country code (e.g. ISO code as required by your integration contract). postCode: type: string country: type: string description: Country name or normalized country label as required by the API. required: - addressLine1 - state - city - countryCode - postCode - country title: AddressDetails TinDocumentType: type: string description: Document type for the tax identifier. title: TinDocumentType TinDetails: type: object properties: documentType: $ref: '#/components/schemas/TinDocumentType' documentNumber: type: string description: >- Tax identification number (e.g. US SSN or India PAN), format as applicable. required: - documentType - documentNumber title: TinDetails IdentityDetailsRequest: type: object properties: personalDetails: $ref: '#/components/schemas/PersonalDetails' addressDetails: $ref: '#/components/schemas/AddressDetails' purposeList: type: array items: type: string description: >- 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"`. tinDetails: $ref: '#/components/schemas/TinDetails' description: >- Tax identification details. **Optional depending on country/regulatory requirements** — required when TIN collection applies for the user's jurisdiction. required: - personalDetails - addressDetails - purposeList title: IdentityDetailsRequest KycRelianceSuccessResponseData: type: object properties: status: type: string description: >- Step or flow status (e.g. `INITIALIZED` after identity or document steps, `SUBMITTED` after biometrics, or terminal outcomes such as `DONE` / `FAILED` as returned by the API). required: - status title: KycRelianceSuccessResponseData KycRelianceSuccessResponse: type: object properties: data: $ref: '#/components/schemas/KycRelianceSuccessResponseData' required: - data title: KycRelianceSuccessResponse ErrorEnvelopeError: type: object properties: statusCode: type: integer message: type: string errorCode: type: integer required: - statusCode - message title: ErrorEnvelopeError ErrorEnvelope: type: object properties: error: $ref: '#/components/schemas/ErrorEnvelopeError' required: - error title: ErrorEnvelope KycRelianceFlatError: type: object properties: statusCode: type: integer errorCode: type: integer message: type: string required: - statusCode - errorCode - message title: KycRelianceFlatError Kyc-reliance-identity-detailsRequestBadRequestError: oneOf: - $ref: '#/components/schemas/ErrorEnvelope' - $ref: '#/components/schemas/KycRelianceFlatError' title: Kyc-reliance-identity-detailsRequestBadRequestError ``` ## SDK Code Examples ```python Success import requests url = "https://api-gateway-stg.transak.com/kyc/v2/reliance/identity-details" payload = { "personalDetails": { "firstName": "Emily", "lastName": "Johnson", "dob": "1990-04-15", "mobileNumber": "+14155552671" }, "addressDetails": { "addressLine1": "123 Maple Street", "state": "California", "city": "San Francisco", "countryCode": "US", "postCode": "94107", "country": "United States", "addressLine2": "Apt 4B" }, "purposeList": ["Buying/selling crypto for investments", "Buying NFTs", "Buying crypto to use a web3 protocol"], "tinDetails": { "documentType": "SSN", "documentNumber": "123-45-6789" } } headers = {"Content-Type": "application/json"} response = requests.post(url, json=payload, headers=headers) print(response.json()) ``` ```javascript Success const url = 'https://api-gateway-stg.transak.com/kyc/v2/reliance/identity-details'; const options = { method: 'POST', headers: {'Content-Type': 'application/json'}, body: '{"personalDetails":{"firstName":"Emily","lastName":"Johnson","dob":"1990-04-15","mobileNumber":"+14155552671"},"addressDetails":{"addressLine1":"123 Maple Street","state":"California","city":"San Francisco","countryCode":"US","postCode":"94107","country":"United States","addressLine2":"Apt 4B"},"purposeList":["Buying/selling crypto for investments","Buying NFTs","Buying crypto to use a web3 protocol"],"tinDetails":{"documentType":"SSN","documentNumber":"123-45-6789"}}' }; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go Success package main import ( "fmt" "strings" "net/http" "io" ) func main() { url := "https://api-gateway-stg.transak.com/kyc/v2/reliance/identity-details" payload := strings.NewReader("{\n \"personalDetails\": {\n \"firstName\": \"Emily\",\n \"lastName\": \"Johnson\",\n \"dob\": \"1990-04-15\",\n \"mobileNumber\": \"+14155552671\"\n },\n \"addressDetails\": {\n \"addressLine1\": \"123 Maple Street\",\n \"state\": \"California\",\n \"city\": \"San Francisco\",\n \"countryCode\": \"US\",\n \"postCode\": \"94107\",\n \"country\": \"United States\",\n \"addressLine2\": \"Apt 4B\"\n },\n \"purposeList\": [\n \"Buying/selling crypto for investments\",\n \"Buying NFTs\",\n \"Buying crypto to use a web3 protocol\"\n ],\n \"tinDetails\": {\n \"documentType\": \"SSN\",\n \"documentNumber\": \"123-45-6789\"\n }\n}") req, _ := http.NewRequest("POST", url, payload) req.Header.Add("Content-Type", "application/json") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby Success require 'uri' require 'net/http' url = URI("https://api-gateway-stg.transak.com/kyc/v2/reliance/identity-details") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Post.new(url) request["Content-Type"] = 'application/json' request.body = "{\n \"personalDetails\": {\n \"firstName\": \"Emily\",\n \"lastName\": \"Johnson\",\n \"dob\": \"1990-04-15\",\n \"mobileNumber\": \"+14155552671\"\n },\n \"addressDetails\": {\n \"addressLine1\": \"123 Maple Street\",\n \"state\": \"California\",\n \"city\": \"San Francisco\",\n \"countryCode\": \"US\",\n \"postCode\": \"94107\",\n \"country\": \"United States\",\n \"addressLine2\": \"Apt 4B\"\n },\n \"purposeList\": [\n \"Buying/selling crypto for investments\",\n \"Buying NFTs\",\n \"Buying crypto to use a web3 protocol\"\n ],\n \"tinDetails\": {\n \"documentType\": \"SSN\",\n \"documentNumber\": \"123-45-6789\"\n }\n}" response = http.request(request) puts response.read_body ``` ```java Success import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.post("https://api-gateway-stg.transak.com/kyc/v2/reliance/identity-details") .header("Content-Type", "application/json") .body("{\n \"personalDetails\": {\n \"firstName\": \"Emily\",\n \"lastName\": \"Johnson\",\n \"dob\": \"1990-04-15\",\n \"mobileNumber\": \"+14155552671\"\n },\n \"addressDetails\": {\n \"addressLine1\": \"123 Maple Street\",\n \"state\": \"California\",\n \"city\": \"San Francisco\",\n \"countryCode\": \"US\",\n \"postCode\": \"94107\",\n \"country\": \"United States\",\n \"addressLine2\": \"Apt 4B\"\n },\n \"purposeList\": [\n \"Buying/selling crypto for investments\",\n \"Buying NFTs\",\n \"Buying crypto to use a web3 protocol\"\n ],\n \"tinDetails\": {\n \"documentType\": \"SSN\",\n \"documentNumber\": \"123-45-6789\"\n }\n}") .asString(); ``` ```php Success request('POST', 'https://api-gateway-stg.transak.com/kyc/v2/reliance/identity-details', [ 'body' => '{ "personalDetails": { "firstName": "Emily", "lastName": "Johnson", "dob": "1990-04-15", "mobileNumber": "+14155552671" }, "addressDetails": { "addressLine1": "123 Maple Street", "state": "California", "city": "San Francisco", "countryCode": "US", "postCode": "94107", "country": "United States", "addressLine2": "Apt 4B" }, "purposeList": [ "Buying/selling crypto for investments", "Buying NFTs", "Buying crypto to use a web3 protocol" ], "tinDetails": { "documentType": "SSN", "documentNumber": "123-45-6789" } }', 'headers' => [ 'Content-Type' => 'application/json', ], ]); echo $response->getBody(); ``` ```csharp Success using RestSharp; var client = new RestClient("https://api-gateway-stg.transak.com/kyc/v2/reliance/identity-details"); var request = new RestRequest(Method.POST); request.AddHeader("Content-Type", "application/json"); request.AddParameter("application/json", "{\n \"personalDetails\": {\n \"firstName\": \"Emily\",\n \"lastName\": \"Johnson\",\n \"dob\": \"1990-04-15\",\n \"mobileNumber\": \"+14155552671\"\n },\n \"addressDetails\": {\n \"addressLine1\": \"123 Maple Street\",\n \"state\": \"California\",\n \"city\": \"San Francisco\",\n \"countryCode\": \"US\",\n \"postCode\": \"94107\",\n \"country\": \"United States\",\n \"addressLine2\": \"Apt 4B\"\n },\n \"purposeList\": [\n \"Buying/selling crypto for investments\",\n \"Buying NFTs\",\n \"Buying crypto to use a web3 protocol\"\n ],\n \"tinDetails\": {\n \"documentType\": \"SSN\",\n \"documentNumber\": \"123-45-6789\"\n }\n}", ParameterType.RequestBody); IRestResponse response = client.Execute(request); ``` ```swift Success import Foundation let headers = ["Content-Type": "application/json"] let parameters = [ "personalDetails": [ "firstName": "Emily", "lastName": "Johnson", "dob": "1990-04-15", "mobileNumber": "+14155552671" ], "addressDetails": [ "addressLine1": "123 Maple Street", "state": "California", "city": "San Francisco", "countryCode": "US", "postCode": "94107", "country": "United States", "addressLine2": "Apt 4B" ], "purposeList": ["Buying/selling crypto for investments", "Buying NFTs", "Buying crypto to use a web3 protocol"], "tinDetails": [ "documentType": "SSN", "documentNumber": "123-45-6789" ] ] as [String : Any] let postData = JSONSerialization.data(withJSONObject: parameters, options: []) let request = NSMutableURLRequest(url: NSURL(string: "https://api-gateway-stg.transak.com/kyc/v2/reliance/identity-details")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "POST" request.allHTTPHeaderFields = headers request.httpBody = postData as Data let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ```