> For a complete page index, fetch https://docs.transak.com/llms.txt

# KYC Reliance using APIs

[KYC Reliance using API](/features/kyc-reliance-apis#api-overview) lets you submit KYC your platform has already completed (via `Sumsub`, `Onfido`, or any provider), so end-users don't repeat KYC for Transak. Transak validates the submission and relies on your KYC instead of re-running it, cutting friction and drop-off while meeting Transak's compliance requirements.

> **Info**
>
> **EEA users:** send the `sourceOfIncome` and `additionalDetails` objects in the Identity Details API, and do not send driving licences. Send the `consent` object only when Get Additional Requirements returns `type: CONSENT` for the user. See [MiCA Changes for EEA Users](/guides/mica-eea-changes).

## Our Solution

<table>
  <tbody>
    <tr>
      <td>
        **Provider agnostic**

        Partners are not limited to a single KYC vendor. They can collect KYC data using providers like `Sumsub`, `Onfido`, and map that data via **Transak’s [KYC Reliance using API](/features/kyc-reliance-apis#api-overview)**.
      </td>
    </tr>

    <tr>
      <td>
        **Aggregated payloads**

        All required data such as personal details, address, purpose of usage, and country-specific ID documents can be submitted together in a **single API call**, instead of multiple calls.
      </td>
    </tr>
  </tbody>
</table>

## How to integrate?

#### Whitelist Your API Keys

| Action                                                                                                                                     |
| ------------------------------------------------------------------------------------------------------------------------------------------ |
| Follow the steps in the [Need help in Integration](/help/contact-us) section                                                               |
| Request **API key whitelisting** and ask to **enable [KYC Reliance using API](/features/kyc-reliance-apis#api-overview)** for your API key |
| Share your **public IP addresses** with Transak for whitelisting to use our APIs in your backend                                           |

#### Submit user details (profile, address, purpose, and ID Document details)

Call the [Identity Details API](/api/whitelabel/kyc-reliance-api/kyc-reliance-identity-details) with a **single combined payload**.

This should include the following data:

**Personal Details** (required)

| Key               | Sub Key        | Test data                       |
| ----------------- | -------------- | ------------------------------- |
| `personalDetails` | `firstName`    | Jane                            |
|                   | `lastName`     | Doe                             |
|                   | `dob`          | 1998-01-01                      |
|                   | `mobileNumber` | +33791112345                    |
| `addressDetails`  | `addressLine1` | 170 Rue du Faubourg Saint-Denis |
|                   | `countryCode`  | FR                              |
|                   | `postCode`     | 75010                           |
|                   | `state`        | Paris                           |
|                   | `city`         | Paris                           |
|                   | `addressLine2` | optional                        |

**PURPOSE OF USAGE** (required)

| key           | description                                                                                          |
| ------------- | ---------------------------------------------------------------------------------------------------- |
| purposeList\* | `"Buying/selling crypto for investments"`, `"Buying NFTs"`, `"Buying crypto to use a web3 protocol"` |

**TIN Details** (optional)

| key              | description           |
| ---------------- | --------------------- |
| documentType\*   | \[US_SSN]             |
| documentNumber\* | Identification number |

Use the same allowed `purposeList` values as existing API contract.
Country-specific tax ID details are required only when applicable, for example `US_SSN` for the `United States`.

#### Submit identity documents

Call the [Document Details API](/api/whitelabel/kyc-reliance-api/kyc-reliance-document-details) with this below fields:

| Key             | Description                                                                                    |
| --------------- | ---------------------------------------------------------------------------------------------- |
| idType\*        | Type of Document IDs (see [**Supported Document IDs**](#supported-document-ids) section below) |
| idCountryCode\* | Country code where the document was issued                                                     |
| idNumber\*      | Document identification number                                                                 |
| frontImage\*    | Front image of the document (base64, max 5MB)                                                  |
| backImage       | Back image of the document (base64, max 5MB) (optional)                                        |

> **Info**
>
> **idNumber** field is Optional only for `PROOF_OF_RESIDENCE` document type. For all other document types, idNumber is required.

#### Submit biometrics (selfie and liveness)

Call the [Biometrics Details API](/api/whitelabel/kyc-reliance-api/kyc-reliance-biometrics-details) to submit the user's biometric verification media.

Both values must be **base64-encoded** and sent as data URIs. See [**Supported formats**](#supported-formats) for the accepted file types.

```
data:<mime-type>;base64,<base64_encoded_data>
```

Example: `data:image/png;base64,<base64_encoded_data>`

Either both or any other can be submitted for `selfie` and `liveness` to complete the KYC submission.

### Supported Formats

| Media type                                        | Accepted formats |
| ------------------------------------------------- | ---------------- |
| **Selfie Image** (document ID front/back, selfie) | JPEG PNG WEBP    |
| **liveness Video**                                | MP4              |

### Supported Document IDs

| idType               | Accepted documents                                             |
| -------------------- | -------------------------------------------------------------- |
| `PASSPORT`           | `passport`                                                     |
| `DRIVING_LICENSE`    | `Driving Licence`                                              |
| `ID_CARD`            | `National Identity Card`                                       |
| `PROOF_OF_RESIDENCE` | `Bank Statement`, `Resident Permit`, `Utility Bill`, `Payslip` |
| `VISA`               | `visa`                                                         |
| `UNKNOWN`            | Any other value not listed above                               |

## Field Validation

### Personal & Address Fields

| Field                    | Constraint                                                                                                                                                                                                                                                                                                                                                                                                |
| ------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **firstName / lastName** | 1–50 characters, counted after conversion (`ß` counts as `ss`). Latin letters, including accented letters (for example `é`, `ø`, `ł`, `ß`), which are converted to plain letters.  Cannot contain `^ ! # $ % * = < > ; { } "` or a backslash; typographic double quotes `“ ”` count as ". Letters from other scripts (Cyrillic, Greek, Arabic, Chinese and so on), symbols, `°` and `№ `are not accepted. |
| **addressLine1**         | 3–200 characters, with at least one letter. Latin letters, including accented letters, which are converted to plain letters, `№` becomes `No`, and `º` and `°` become `o`. Letters from other scripts and symbols are not accepted.                                                                                                                                                                       |
| **addressLine2**         | **Optional** Up to 200 characters. If sent, it must contain at least one letter (`Apt 12` is accepted, `12` alone is not). Same character rules as `addressLine1`.                                                                                                                                                                                                                                        |
| **city**                 | 2 to 50 characters, with at least one letter.                                                                                                                                                                                                                                                                                                                                                             |
| **state**                | 2 to 100 characters, with at least one letter.                                                                                                                                                                                                                                                                                                                                                            |
| **postCode**             | Must be a valid postal code for the given `countryCode`                                                                                                                                                                                                                                                                                                                                                   |
| **dob**                  | ISO 8601 date (`YYYY-MM-DD`). User must be ≥ 18 and \< 150 years old                                                                                                                                                                                                                                                                                                                                      |
| **mobileNumber**         | Must be a valid international phone number (E.164 format, e.g. `+33791112345`)                                                                                                                                                                                                                                                                                                                            |

Transak keeps the name and address exactly as sent and uses the converted form for verification (for example `Søren Ólafsdóttir` is verified as `Soren Olafsdottir`). Invisible characters and extra spacing are removed, and typographic quotes and dashes are converted to their plain form before the value is checked.

### Field patterns

| Field               | Pattern                                                |
| ------------------- | ------------------------------------------------------ |
| firstName, lastName | `^(?!\s+$)[NAME_CHARACTERS]{1,50}$`                    |
| addressLine1        | `^(?!\s+$)(?=.*[LETTERS])[ADDRESS_CHARACTERS]{3,200}$` |
| addressLine2        | `^(?=.*[LETTERS])[ADDRESS_CHARACTERS]{0,200}$\|^\s*$`  |
| city                | `^(?!\s+$)(?=.*[LETTERS])[ADDRESS_CHARACTERS]{2,50}$`  |
| state               | `^(?!\s+$)(?=.*[LETTERS])[ADDRESS_CHARACTERS]{2,100}$` |

### Tin Details

| Value    | Applicable country | `documentNumber` format     |
| -------- | ------------------ | --------------------------- |
| `US_SSN` | `US`               | 9 digits (e.g. `123456789`) |

## How to encode images and video as Base64

All document images, selfies, and liveness media should be sent as `Base64-encoded` strings.

* The encoded value must be a single continuous string (no line breaks or spaces).
* Ensure the full file is encoded — do not truncate the string.

### Encode a file as Base64 (example snippets)

#### Node.js

**`Node.js`**

```javascript title="Node.js"
const fs = require('fs');

// Supported image formats: JPEG, PNG, WEBP
// Supported video format: MP4
const filePath = './id-front.jpg';
const mimeType = 'image/jpeg'; // e.g. image/png, image/webp, video/mp4

const base64Data = fs.readFileSync(filePath, { encoding: 'base64' });
const encoded = `data:${mimeType};base64,${base64Data}`;
// Send `encoded` in the API request body
```

#### Python

**`Python 3`**

```python title="Python 3"
import base64
from pathlib import Path

# Supported image formats: JPEG, PNG, WEBP
# Supported video format: MP4
file_path = Path("id-front.jpg")
mime_type = "image/jpeg"  # e.g. image/png, image/webp, video/mp4

b64_data = base64.b64encode(file_path.read_bytes()).decode("ascii")
encoded = f"data:{mime_type};base64,{b64_data}"
# Send `encoded` in the API request body
```

#### Java

**`Java`**

```java title="Java"
import java.nio.file.Files;
import java.nio.file.Path;
import java.util.Base64;

// Supported image formats: JPEG, PNG, WEBP
// Supported video format: MP4
byte[] bytes = Files.readAllBytes(Path.of("id-front.jpg"));
String mimeType = "image/jpeg"; // e.g. image/png, image/webp, video/mp4
String b64Data = Base64.getEncoder().encodeToString(bytes);
String encoded = "data:" + mimeType + ";base64," + b64Data;
// Send `encoded` in the API request body
```

#### Go

**`Go`**

```go title="Go"
import (
	"encoding/base64"
	"fmt"
	"os"
)

// Supported image formats: JPEG, PNG, WEBP
// Supported video format: MP4
fileBytes, _ := os.ReadFile("id-front.jpg") // handle error in production
mimeType := "image/jpeg"                    // e.g. image/png, image/webp, video/mp4
b64Data := base64.StdEncoding.EncodeToString(fileBytes)
encoded := fmt.Sprintf("data:%s;base64,%s", mimeType, b64Data)
// Send `encoded` in the API request body
```

#### PHP

**`PHP`**

```php title="PHP"
<?php
// Supported image formats: JPEG, PNG, WEBP
// Supported video format: MP4
$path     = 'id-front.jpg';
$mimeType = 'image/jpeg'; // e.g. image/png, image/webp, video/mp4

$b64Data = base64_encode(file_get_contents($path));
$encoded = "data:{$mimeType};base64,{$b64Data}";
// Send `$encoded` in the API request body
```

## How does it work?

## Current Limitations

<table>
  <thead>
    <tr>
      <th>
        Limitation
      </th>

      <th>
        Details
      </th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>
        **KYC Reliance APIs**
      </td>

      <td>
        The KYC Reliance API must be called only from the partner's backend and subjected to the whitelisting of partner IP addresses. Direct API calls from the frontend apps are not supported.
      </td>
    </tr>

    <tr>
      <td>
        **FCA Flow (For UK Users) not supported**
      </td>

      <td>
        Partners can integrate the APIs to submit the FCA requirements. See the [How to Submit FCA Requirements](https://docs.transak.com/guides/how-to-submit-fca) guide for step-by-step instructions.
      </td>
    </tr>
  </tbody>
</table>

## API Overview

#### [Identity Details API](/api/whitelabel/kyc-reliance-api/kyc-reliance-identity-details)

Submits the user's `personal details`, `address`, `purpose of usage`, and optional `tax identifier (TIN)` data to initialize the KYC Reliance flow.

#### [Document Details API](/api/whitelabel/kyc-reliance-api/kyc-reliance-document-details)

Submit ID proof document images (e.g. `PASSPORT`, `DRIVING_LICENSE`) as **base64-encoded** data.

#### [Biometrics Details API](/api/whitelabel/kyc-reliance-api/kyc-reliance-biometrics-details)

Submit the user's `selfie image` or `liveness video` as **base64-encoded** data to complete the KYC submission.

## API Errors

#### Identity Details API

| Status Code | Error Code | Message                                                                                                                                                                                                                                                                      |
| ----------- | ---------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 401         | 1002       | Invalid or missing authentication token.                                                                                                                                                                                                                                     |
| 401         | 1002       | authorization or x-access-token+x-user-identifier required                                                                                                                                                                                                                   |
| 401         | 1014       | Invalid or missing access-token.                                                                                                                                                                                                                                             |
| 401         | 1002       | Invalid or expired token                                                                                                                                                                                                                                                     |
| 401         | 1010       | Invalid token                                                                                                                                                                                                                                                                |
| 401         | 1023       | User not found. Please onboard the user first.                                                                                                                                                                                                                               |
| 401         | 1002       | Auth reliance feature is not enabled for this partner                                                                                                                                                                                                                        |
| 401         | 1002       | API key is not active. Please complete the KYC to go live with us.                                                                                                                                                                                                           |
| 401         | 1002       | IP not authorized                                                                                                                                                                                                                                                            |
| 403         | 9001       | IP not authorized                                                                                                                                                                                                                                                            |
| 401         | 1002       | Invalid access token                                                                                                                                                                                                                                                         |
| 403         | 1024       | Services are temporarily unavailable in your region. Please bear with us - we expect to be back soon.                                                                                                                                                                        |
| 400         | 9001       | Invalid request payload JSON format                                                                                                                                                                                                                                          |
| 413         | 9001       | Payload content length greater than maximum allowed: 1048576                                                                                                                                                                                                                 |
| 403         | 9999       | KYC reliance v2 is not allowed for partner                                                                                                                                                                                                                                   |
| 400         | 9001       | personalDetails is required                                                                                                                                                                                                                                                  |
| 400         | 9001       | firstName is required in personalDetails                                                                                                                                                                                                                                     |
| 400         | 9001       | lastName is required in personalDetails                                                                                                                                                                                                                                      |
| 400         | 9001       | dob is required in personalDetails                                                                                                                                                                                                                                           |
| 400         | 9001       | addressDetails is required                                                                                                                                                                                                                                                   |
| 400         | 9001       | countryCode is required in addressDetails                                                                                                                                                                                                                                    |
| 400         | 9001       | postCode is required in addressDetails                                                                                                                                                                                                                                       |
| 400         | 9001       | purposeList is required and must be a non-empty array                                                                                                                                                                                                                        |
| 400         | 9001       | documentType must be US_SSN or PAN_NUMBER                                                                                                                                                                                                                                    |
| 400         | 9001       | documentNumber is required in tinDetails                                                                                                                                                                                                                                     |
| 400         | 9001       | Invalid request payload input                                                                                                                                                                                                                                                |
| 400         | 9999       | KYC is not required for this user                                                                                                                                                                                                                                            |
| 400         | 9999       | firstName is required                                                                                                                                                                                                                                                        |
| 400         | 9999       | lastName is required                                                                                                                                                                                                                                                         |
| 400         | 9999       | mobileNumber is a required argument                                                                                                                                                                                                                                          |
| 400         | 9999       | mobileNumber is required                                                                                                                                                                                                                                                     |
| 400         | 9999       | Invalid date                                                                                                                                                                                                                                                                 |
| 400         | 9999       | Invalid date of birth                                                                                                                                                                                                                                                        |
| 400         | 3002       | You don't meet our age requirements                                                                                                                                                                                                                                          |
| 400         | 2021       | The phone number entered is invalid. Please check the selected country and entered digits.                                                                                                                                                                                   |
| 400         | 2020       | This phone number is already registered. It has been used by an account created with \{masked email}. Login with this email to continue.                                                                                                                                     |
| 400         | 9999       | addressLine1 is a required argument                                                                                                                                                                                                                                          |
| 400         | 9999       | city is a required argument                                                                                                                                                                                                                                                  |
| 400         | 9999       | addressLine1 is required                                                                                                                                                                                                                                                     |
| 400         | 9999       | city is required                                                                                                                                                                                                                                                             |
| 400         | 9999       | postCode is required                                                                                                                                                                                                                                                         |
| 400         | 9999       | Address Line should be greater than 2 characters!                                                                                                                                                                                                                            |
| 400         | 9999       | Address Line should be less than 201 characters!                                                                                                                                                                                                                             |
| 400         | 9999       | Address Line 2 should be less than 201 characters!                                                                                                                                                                                                                           |
| 400         | 9999       | City should be greater than 1 characters!                                                                                                                                                                                                                                    |
| 400         | 9999       | City should be less than 51 characters!                                                                                                                                                                                                                                      |
| 400         | 9999       | State/Region should be greater than 1 characters!                                                                                                                                                                                                                            |
| 400         | 9999       | State/Region should be less than 101 characters!                                                                                                                                                                                                                             |
| 400         | 9999       | Your first name contains unsupported characters. Please enter it as shown on your ID.                                                                                                                                                                                        |
| 400         | 9999       | Your last name contains unsupported characters. Please enter it as shown on your ID.                                                                                                                                                                                         |
| 400         | 9999       | Your address line contains unsupported characters. Please enter it as shown on your ID.                                                                                                                                                                                      |
| 400         | 9999       | Your address line2 contains unsupported characters. Please enter it as shown on your ID.                                                                                                                                                                                     |
| 400         | 9999       | Your city name contains unsupported characters. Please enter it as shown on your ID.                                                                                                                                                                                         |
| 400         | 9999       | Your state name contains unsupported characters. Please enter it as shown on your ID.                                                                                                                                                                                        |
| 400         | 9999       | Following characters not allowed for name: ^,!,#,\$,%,\*,=,\<,>,;,\{,},"                                                                                                                                                                                                     |
| 400         | 9999       | First Name should be less than 51 characters!                                                                                                                                                                                                                                |
| 400         | 9999       | Last Name should be less than 51 characters!                                                                                                                                                                                                                                 |
| 400         | 9999       | 'Address Line' field should have at least 1 alphabet! Please check and enter a valid Address Line                                                                                                                                                                            |
| 400         | 9999       | 'Address Line 2' field should have at least 1 alphabet! Please check and enter a valid Address Line 2                                                                                                                                                                        |
| 400         | 9999       | 'City' field should have at least 1 alphabet! Please check and enter a valid City                                                                                                                                                                                            |
| 400         | 9999       | 'State' field should have at least 1 alphabet! Please check and enter a valid State                                                                                                                                                                                          |
| 400         | 3015       | Invalid postal codes, please enter your country postal code                                                                                                                                                                                                                  |
| 400         | 9999       | Please enter your postal code in English only! Remove accented characters, if any.                                                                                                                                                                                           |
| 400         | 9999       | Invalid country selection                                                                                                                                                                                                                                                    |
| 400         | 9999       | Unfortunately, we do not support your region. We are actively working on expanding our coverage!                                                                                                                                                                             |
| 400         | 9999       | \{state}, \{country} residents can't access crypto services due to regulatory changes. Please update your location if incorrect.                                                                                                                                             |
| 400         | 9999       | \{country} residents can't access crypto services due to regulatory changes. Please update your location if incorrect.                                                                                                                                                       |
| 400         | 9999       | Transak service update: Currently unavailable for United Kingdom residents via this partner. Please place your order directly at [https://global.transak.com](https://global.transak.com). Contact [https://support.transak.com](https://support.transak.com) for questions. |
| 400         | 9999       | We do not accept PO box as a valid form of address.                                                                                                                                                                                                                          |
| 400         | 9999       | Missing required reliance data: tinDetails                                                                                                                                                                                                                                   |
| 400         | 2022       | Invalid SSN. Please enter a valid Social Security Number.                                                                                                                                                                                                                    |
| 400         | 2033       | This SSN is already registered. It has been used by an account created with \{masked email}. Login with this email to continue.                                                                                                                                              |
| 400         | 9999       | "purposeList\[\{index}]" must be one of \[Buying/selling crypto for investments, Buying NFTs, Buying crypto to use a web3 protocol]                                                                                                                                          |
| 400         | 9999       | "purposeList" must contain less than or equal to 10 items                                                                                                                                                                                                                    |
| 400         | 9999       | Invalid countryCode: "\{value}"                                                                                                                                                                                                                                              |
| 400         | 9001       | consentedAt is required                                                                                                                                                                                                                                                      |
| 400         | 9999       | Consent timestamps must be ISO 8601 with a timezone offset, e.g. 2026-09-01T10:15:00Z                                                                                                                                                                                        |
| 400         | 9001       | sourceOfFundsType is required in sourceOfIncome                                                                                                                                                                                                                              |
| 400         | 9999       | Invalid employment status                                                                                                                                                                                                                                                    |
| 400         | 9999       | Unable to submit KYC reliance data                                                                                                                                                                                                                                           |
| 503         | 9999       | Service Unavailable                                                                                                                                                                                                                                                          |
| 500         | Varies     | Varies                                                                                                                                                                                                                                                                       |

#### Document Details API

| Status Code | Error Code | Message                                                                                                       |
| ----------- | ---------- | ------------------------------------------------------------------------------------------------------------- |
| 401         | 1002       | Invalid or missing authentication token.                                                                      |
| 401         | 1002       | authorization or x-access-token+x-user-identifier required                                                    |
| 401         | 1014       | Invalid or missing access-token.                                                                              |
| 401         | 1002       | Invalid or expired token                                                                                      |
| 401         | 1010       | Invalid token                                                                                                 |
| 401         | 1023       | User not found. Please onboard the user first.                                                                |
| 401         | 1002       | Auth reliance feature is not enabled for this partner                                                         |
| 401         | 1002       | API key is not active. Please complete the KYC to go live with us.                                            |
| 401         | 1002       | IP not authorized                                                                                             |
| 403         | 9001       | IP not authorized                                                                                             |
| 401         | 1002       | Invalid access token                                                                                          |
| 403         | 1024       | Services are temporarily unavailable in your region. Please bear with us - we expect to be back soon.         |
| 400         | 9001       | Invalid request payload JSON format                                                                           |
| 413         | 9001       | Payload content length greater than maximum allowed: 13983064                                                 |
| 400         | 9001       | documentProof is required                                                                                     |
| 400         | 9001       | idType must be one of PASSPORT, DRIVING_LICENSE, ID_CARD, VISA, PROOF_OF_RESIDENCE, UNKNOWN                   |
| 400         | 9001       | idCountryCode must be a 2-letter ISO uppercase country code                                                   |
| 400         | 9001       | idNumber is required in documentProof                                                                         |
| 400         | 9001       | frontImage is required in documentProof                                                                       |
| 400         | 9001       | frontImage must not exceed 6990508 characters in documentProof                                                |
| 400         | 9001       | backImage must not exceed 6990508 characters in documentProof                                                 |
| 400         | 9001       | Invalid request payload input                                                                                 |
| 404         | 9999       | KYC request not found                                                                                         |
| 400         | 9999       | "documentProof.backImage" is not allowed to be empty                                                          |
| 400         | 9999       | "documentProof.idCountry" with value "\{value}" fails to match the required pattern: /^\[A-Z]\{2,3}\$/        |
| 400         | 9999       | Invalid countryCode: "\{value}"                                                                               |
| 400         | 9999       | Invalid documentProof.frontImage: must be a non-empty base64 string                                           |
| 400         | 9999       | Invalid documentProof.backImage: must be a non-empty base64 string                                            |
| 400         | 9999       | Invalid documentProof.frontImage: base64 data is empty                                                        |
| 400         | 9999       | Invalid documentProof.backImage: base64 data is empty                                                         |
| 400         | 9999       | Invalid documentProof.frontImage: unsupported MIME type "\{type}". Allowed: image/jpeg, image/png, image/webp |
| 400         | 9999       | Invalid documentProof.backImage: unsupported MIME type "\{type}". Allowed: image/jpeg, image/png, image/webp  |
| 400         | 9999       | Unable to submit KYC reliance data                                                                            |
| 503         | 9999       | Service Unavailable                                                                                           |
| 500         | Varies     | Varies                                                                                                        |

#### Biometrics Details API

| Status Code | Error Code | Message                                                                                               |
| ----------- | ---------- | ----------------------------------------------------------------------------------------------------- |
| 401         | 1002       | Invalid or missing authentication token.                                                              |
| 401         | 1002       | authorization or x-access-token+x-user-identifier required                                            |
| 401         | 1014       | Invalid or missing access-token.                                                                      |
| 401         | 1002       | Invalid or expired token                                                                              |
| 401         | 1010       | Invalid token                                                                                         |
| 401         | 1023       | User not found. Please onboard the user first.                                                        |
| 401         | 1002       | Auth reliance feature is not enabled for this partner                                                 |
| 401         | 1002       | API key is not active. Please complete the KYC to go live with us.                                    |
| 401         | 1002       | IP not authorized                                                                                     |
| 403         | 9001       | IP not authorized                                                                                     |
| 401         | 1002       | Invalid access token                                                                                  |
| 403         | 1024       | Services are temporarily unavailable in your region. Please bear with us - we expect to be back soon. |
| 400         | 9001       | Invalid request payload JSON format                                                                   |
| 413         | 9001       | Payload content length greater than maximum allowed: 20973572                                         |
| 400         | 9001       | at least one of selfie or liveness is required                                                        |
| 400         | 9001       | selfie must not be empty                                                                              |
| 400         | 9001       | liveness must not be empty                                                                            |
| 400         | 9001       | selfie must not exceed 6990508 characters                                                             |
| 400         | 9001       | liveness must not exceed 13981016 characters                                                          |
| 400         | 9001       | Invalid request payload input                                                                         |
| 404         | 9999       | KYC request not found                                                                                 |
| 400         | 9999       | document-details to be called first                                                                   |
| 400         | 9999       | Invalid selfie: must be a non-empty base64 string                                                     |
| 400         | 9999       | Invalid selfie: base64 data is empty                                                                  |
| 400         | 9999       | Invalid selfie: unsupported MIME type "\{type}". Allowed: image/jpeg, image/png, image/webp           |
| 400         | 9999       | Invalid liveness: must be a non-empty base64 string                                                   |
| 400         | 9999       | Invalid liveness: base64 data is empty                                                                |
| 400         | 9999       | Invalid liveness: unsupported MIME type "\{type}". Allowed: image/jpeg, image/png, image/webp         |
| 400         | 9999       | Invalid liveness: decoded size \{n} bytes exceeds 5MB limit                                           |
| 400         | 9999       | tinDetails.type must be "SSN" for country USA, got "PAN".                                             |
| 400         | 9999       | tinDetails.countryCode must be "USA" for country USA, got "undefined".                                |
| 400         | 9999       | Invalid date of birth                                                                                 |
| 400         | 1024       | Services are temporarily unavailable in your region. Please bear with us - we expect to be back soon. |
| 400         | 9999       | Incomplete KYC submission. Required details not received: \{fields}                                   |
| 400         | 9999       | Unable to submit KYC reliance data                                                                    |
| 503         | 9999       | Service Unavailable                                                                                   |
| 500         | Varies     | Varies                                                                                                |