# Identity History

This endpoint allows the user to retrieve their verified identity verification history.

<mark style="color:blue;">`GET`</mark> `{{baseurl}}/v2/api/identity/history`

#### Path Parameters

| Name  | Type   | Description                                                                                                                                                                 |
| ----- | ------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| page  | String | <p>Page number of the requested page.</p><p>Default value: <mark style="color:red;"><code>1</code></mark></p>                                                               |
| limit | String | <p>number of logs to return.</p><p>Default value: <mark style="color:red;"><code>20</code></mark></p><p>Maximum Value: <mark style="color:red;"><code>100</code></mark></p> |

#### Headers

| Name                                    | Type   | Description      |
| --------------------------------------- | ------ | ---------------- |
| token<mark style="color:red;">\*</mark> | String | API secret token |

{% tabs %}
{% tab title="Response" %}

```json
HTTP/1.1 200 OK
{
        "success": true,
        "statusCode": 200,
        "message": "All identities retrieved successfully!",
        "data": {
            "docs": [
                {
                    "address": {
                        "town": null,
                        "lga": null,
                        "state": null,
                        "addressLine": null
                    },
                    "parentId": null,
                    "status": "found",
                    "dataValidation": false,
                    "selfieValidation": false,
                    "firstName": null,
                    "middleName": null,
                    "lastName": null,
                    "expiredDate": null,
                    "image": null,
                    "signature": null,
                    "enrollmentBranch": null,
                    "enrollmentInstitution": null,
                    "mobile": null,
                    "email": null,
                    "birthState": null,
                    "nokState": null,
                    "religion": null,
                    "birthLGA": null,
                    "birthCountry": null,
                    "gender": "",
                    "stateOfIssuance": null,
                    "issuedAt": null,
                    "issuedDate": null,
                    "dateOfBirth": null,
                    "reason": null,
                    "notifyWhenIdExpire": false,
                    "phoneDetails": [
                        {
                            "fullName": "JOHN  DOE",
                            "dateOfBirth": "1960-05-24"
                        },
                        {
                            "fullName": "JOHN MICHAEL DOE",
                            "dateOfBirth": "1980-06-03"
                        }
                    ],
                    "isConsent": true,
                    "idNumber": "08000000000",
                    "businessId": "60c895fe05f49025c02cf203",
                    "type": "phone",
                    "requestedAt": "2021-08-02T15:03:03.398Z",
                    "requestedById": "60bffbb0e61d95bd9c3e1a9a",
                    "country": "NG",
                    "createdAt": "2021-08-02T15:03:03.558Z",
                    "lastModifiedAt": "2021-08-02T15:03:03.558Z",
                    "_createdAt": "2021-08-02T16:03:033+01:00",
                    "_lastModifiedAt": "2021-08-02T16:03:033+01:00",
                    "id": "61080927168c5f9075980268",
                    "requestedBy": {
                        "firstName": "John",
                        "lastName": "Doe",
                        "middleName": "Michael",
                        "email": "john.doe@gmail.com",
                        "mobile": "+2348000000000",
                        "countryCode": "NG",
                        "id": "60bffbb0e61d95bd9c3e1a9a"
                    }
                }
            ],
            "pagination": {
                "totalDocs": 67,
                "perPage": 1,
                "totalPages": 67,
                "currentPage": 1,
                "serialNo": 1,
                "hasPrevPage": false,
                "hasNextPage": true,
                "prevPage": null,
                "nextPage": 2
            }
        },
        "links": []
    }

```

{% endtab %}
{% endtabs %}