# Get KYC records by Link

This API allows clients to fetch  KYC records

### Base URL

```
sdk.faceki.com
```

### Generate KYC Link End Point API

```
https://sdk.faceki.com/kycverify/api/kycverify/link
```

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

Authorization: Bearer Token

Content-Type: application/json
{% endhint %}

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

#### Query Parameters

| Name   | Type   | Description                                |
| ------ | ------ | ------------------------------------------ |
| linkId | String | Pass to get specific KYC done on that link |

#### Headers

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

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

```
{
    "responseCode": 0,
    "data": [
        {
            "_id": "",
            "kycResponse": {
            
            },
            "livenessResponse": {
       
            },
            "fullName": "",
            "referenceId": "",
            "documentId": "",
            "DOB": "",
            "localName": "",
            "country": "",
            "countryCode": "",
            "countryCodeISO3": "",
            "idFrontImage": "",
            "idBackImage": "",
            "status": "ACCEPTED",
            "deleteStatus": "ACTIVE",
            "companyId": "",
            "selfieImage": "",
            "documentCropFaceImageUrl": "",
            "faceID": "",
            "difcCode": "",
            "link": "<LINK>",
            "deviceDetails": {},
            "modifiedBy": "",
            "createdAt": "2023-04-16T10:24:10.960Z",
            "updatedAt": "2023-05-26T12:26:02.656Z",
            "__v": 0,
            "requestId": ""
        }
    ]
}
```

{% endtab %}

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

```javascript
    // Response
}
```

{% endtab %}

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

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

{% endtab %}
{% endtabs %}

<figure><img src="https://3621714085-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQdiwjdAaMBpDtolO59Ll%2Fuploads%2FdqzePBsm1nvzR8zvBAXJ%2FWhatsApp%20Image%202023-05-30%20at%204.41.39%20PM.jpeg?alt=media&#x26;token=a25936e4-e998-439d-8e34-40bc247ebd6a" alt=""><figcaption></figcaption></figure>