# Get KYC Rules

This API endpoint allows clients to retrieve the rules associated with a specific KYC workflow based on the document type. The KYC rules provide clients with the necessary information on the mandatory fields and additional requirements for the KYC process.

### Request Header:

* `Authorization`: Bearer \[token] (required): The authentication token for accessing the API.

Response: Upon a successful request, the API will return a response containing the KYC rules associated with the specified document type.

### Base URL

```
sdk.faceki.com
```

### KYC Rules End Point API

```
https://sdk.faceki.com/kycrules/api/kycrules
```

<mark style="color:blue;">`GET`</mark> `https://sdk.faceki.com/kycrules/api/kycrules`

#### Headers

| Name                                             | Type   | Description      |
| ------------------------------------------------ | ------ | ---------------- |
| Content-Type:<mark style="color:red;">\*</mark>  | String | application/json |
| Authorization:<mark style="color:red;">\*</mark> | String | Bearer \[token]  |

{% tabs %}
{% tab title="200: OK " %}

```json
{
    "responseCode": 0,
    "data": {
        "_id": "123",
        "companyId": "1234",
        "__v": 0,
        "allowedCountries": [],
        "allowedKycDocuments": [
            "Passport"
        ],
        "allowedNationalities": [],
        "createdAt": "2023-06-08T06:50:21.354Z",
        "dataStorageTime": "FOREVER",
        "declined": {
            "redirect_url": "https://www.faceki.com",
            "message": "Declined!"
        },
        "invalid": {
            "redirect_url": "https://www.faceki.com",
            "message": "Invalid!"
        },
        "invalidDocuments": [],
        "isRecapturedDocumentInvalid": false,
        "link": "",
        "livenessCheckType": "MODERATE",
        "multiKYCEnabled": true,
        "status": "ACTIVE",
        "storedData": true,
        "success": {
            "redirect_url": "https://www.faceki.com",
            "message": "Success!"
        },
        "updatedAt": "2023-06-10T12:01:25.835Z",
        "validAge": 18
    }
}
```

{% endtab %}

{% tab title="400: Bad Request " %}

```javascript
{
    // Response
}
```

{% endtab %}

{% tab title="401: Unauthorized " %}

```javascript
{
    // Response
}
```

{% endtab %}

{% tab title="403: Forbidden " %}

```javascript
{
    // Response
}
```

{% endtab %}

{% tab title="404: Not Found " %}

```javascript
{
    // Response
}
```

{% endtab %}

{% tab title="500: Internal Server Error " %}

```javascript
{
    // Response
}
```

{% endtab %}
{% endtabs %}

{% hint style="info" %}
Method: GET

Authorization: Bearer Token
{% endhint %}

<figure><img src="/files/XP18BfRUVQD2Pqf6Lghv" alt=""><figcaption></figcaption></figure>

By utilizing the "Get KYC Rules" API, clients can retrieve the specific rules and requirements associated with different KYC workflows, allowing them to tailor their user interfaces and data collection processes accordingly. This enhances the overall user experience and ensures compliance with KYC regulations.

<br>

<br>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://kycdocv2.faceki.com/api-integration/verification-apis/get-kyc-rules.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.