Identity History

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

GET {{baseurl}}/v2/api/identity/history

Path Parameters

NameTypeDescription

page

String

Page number of the requested page.

Default value: 1

limit

String

number of logs to return.

Default value: 20

Maximum Value: 100

Headers

NameTypeDescription

token*

String

API secret token

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": []
    }

Last updated