# Request Ident Link

The client has successfully entered their information and this has been transmitted to Concedus. \
If the client has in some way lost the link to the KYC provider, it has expired or there were other problems with identification, VgV can now request the still active link and a new link itself.

## Request Ident-Link

<mark style="color:green;">`POST`</mark> `https://demo2.api.concedus.com/v2/compliance/idents`

### **Headers**

<table><thead><tr><th>Name</th><th width="264">Type</th><th>Description</th></tr></thead><tbody><tr><td>Content-Type<mark style="color:red;">*</mark></td><td>String</td><td>application/json </td></tr><tr><td>Authorization<mark style="color:red;">*</mark></td><td>String</td><td>Bearer <code>token</code></td></tr></tbody></table>

### **Request Body**

| Field          | Type   | Requirement | Description                                                                                                    |
| -------------- | ------ | ----------- | -------------------------------------------------------------------------------------------------------------- |
| personKey      | String | required    | See: [Key](https://docs.concedus.com/import-process/send-data-sets#key)                                        |
| kycServiceName | String | required    | <p>Chosen KYC-Provider<br>See: <a href="../../import-process/identification#kyc-provider">KYC-Provider</a></p> |

### **Request structure (JSON)**

```json
{
  "personKey": "PERS_XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
  "kycServiceName": "WEBID"
}
```

## Response Body

{% tabs %}
{% tab title="200: OK - New Ident when last is expired" %}

```json
{
    "idents": [
        {
            "kyc": "WEBID",
            "url": "https://test.webid-solutions.de/service/qa/cn/000713/aid/264618XXX",
            "key": "PERS_XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
            "actionId": "264618XXX",
            "status": "pending",
            "transactionId": "XXX909ddXXXaXXXdbbeXXXc13de69XXX"
        }
    ]
}
```

{% endtab %}

{% tab title="200: OK - Latest Ident still pending" %}

```json
{
    "idents": [
        {
            "kyc": "WEBID",
            "url": "https://test.webid-solutions.de/service/qa/cn/000713/aid/264618XXX",
            "key": "PERS_XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
            "actionId": "264618XXX",
            "status": "pending",
            "transactionId": "XXX909ddXXXaXXXdbbeXXXc13de69XXX"
        }
    ]
}
```

{% endtab %}

{% tab title="400: Bad Request - Ident already successfull " %}

```json
{
    "code": "400",
    "info": "Invalid arguments to the API",
    "reason": "Already active Ident for PERS_XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX!"
{

/// In this Case Concedus should be consolidated
```

{% endtab %}

{% tab title="400: Bad Request - Not expired and failed 3 times" %}

```json
{
    "code": "400",
    "info": "Invalid arguments to the API",
    "reason": "PERS_XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX failed Ident over three times!"
}
```

{% endtab %}

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

```json
}
    "code": "404",
    "info": "Item is not found",
    "reason": ""
}
```

{% endtab %}
{% endtabs %}
