Verify National ID

CIV ID Verification

POST {{baseurl}}/v2/api/identity/ci/national-id

This endpoint allows you to perform different types of CIV ID verifications.

Headers

Name	Type	Description
token*	String	API secret token

Request Body

Field	Type	Description
id*	String	National ID NNI number
isSubjectConsent*	Boolean	Indicate subject has given consent. Must be true
validations	Object	Validation object
data	Object	Validation data object
lastName	String	lastname to compare against ID
firstName	String	firstname to compare against ID
dateOfBirth	String	date of birth to compare against ID

CIV ID Verification

CIV ID Verification Sample Request

{
    "id": "11978031809",
    "isSubjectConsent": true
}

CIV ID Verification Sample Response

{
    "success": true,
    "statusCode": 200,
    "message": "success",
    "data": {
        "id": "69325463c04b51be59affb65",
        "parentId": null,
        "status": "found",
        "reason": null,
        "dataValidation": false,
        "selfieValidation": false,
        "firstName": "LONZO HENOCH ANGE MICHAEL",
        "middleName": null,
        "lastName": "KOFFI",
        "fullName": "LONZO HENOCH ANGE MICHAEL KOFFI",
        "fatherFirstName": "KOUADIO LAMBERT",
        "fatherLastName": "KOFFI",
        "motherFirstName": "PIERRE ALICE",
        "motherLastName": "TOUKOURA",
        "fatherDateOfBirth": "1965-02-27",
        "motherDateOfBirth": "1902-02-27",
        "image": null,
        "nationality": "CIV",
        "dateOfBirth": "1999-05-26",
        "isConsent": true,
        "idNumber": "C0117721704",
        "businessId": "62c2a4868d319373a6280152",
        "type": "ciNationalId",
        "allValidationPassed": true,
        "gender": "Male",
        "issuedDate": null,
        "expiredDate": null,
        "documentId": "11978031809",
        "requestedAt": "2025-12-05T03:41:24.017Z",
        "requestedById": "62c2a4868d3193700828014e",
        "country": "CI",
        "createdAt": "2025-12-05T03:41:24.029Z",
        "lastModifiedAt": "2025-12-05T03:41:24.029Z",
        "adverseMediaReport": null,
        "amlReport": null,
        "metadata": {},
        "requestedBy": {
            "firstName": "API",
            "lastName": "User",
            "middleName": "",
            "id": "62c2a4868d3193700828014e"
        }
    },
    "links": []
}

CIV ID Validation

CIV ID Validation Sample Request

{
    "id": "11978031809",
    "isSubjectConsent": true,
    "validations": {
        "data": {
            "lastName": "KOFFI",
            "firstName": "LONZO HENOCH ANGE MICHAEL",
            "dateOfBirth": "1999-05-26"
        }
    }
}

CIV ID Validation Sample Response

{
    "success": true,
    "statusCode": 200,
    "message": "success",
    "data": {
        "id": "6929ab1ed4f3a3f47146cf56",
        "validations": {
            "data": {
                "lastName": {
                    "validated": true,
                    "value": "KOFFI"
                },
                "dateOfBirth": {
                    "validated": true,
                    "value": "1999-05-26"
                },
                "firstName": {
                    "validated": true,
                    "value": "LONZO HENOCH ANGE MICHAEL"
                }
            },
            "validationMessages": "No Photo from data source"
        },
        "parentId": null,
        "status": "found",
        "reason": null,
        "dataValidation": true,
        "selfieValidation": false,
        "firstName": "LONZO HENOCH ANGE MICHAEL",
        "middleName": null,
        "lastName": "KOFFI",
        "fullName": "LONZO HENOCH ANGE MICHAEL KOFFI",
        "fatherFirstName": "KOUADIO LAMBERT",
        "fatherLastName": "KOFFI",
        "motherFirstName": "PIERRE ALICE",
        "motherLastName": "TOUKOURA",
        "fatherDateOfBirth": "1965-02-27",
        "motherDateOfBirth": "1902-02-27",
        "image": null,
        "nationality": "CIV",
        "dateOfBirth": "1999-05-26",
        "isConsent": true,
        "idNumber": "C0117721704",
        "businessId": "61d880f1e8e15aaf24558f1a",
        "type": "ciNationalId",
        "allValidationPassed": false,
        "gender": "Male",
        "issuedDate": null,
        "expiredDate": null,
        "documentId": "11978031809",
        "requestedAt": "2025-11-28T14:01:02.918Z",
        "requestedById": "61d880f1e8e15aaf24558f1c",
        "country": "CI",
        "createdAt": "2025-11-28T14:01:03.063Z",
        "lastModifiedAt": "2025-11-28T14:01:03.063Z",
        "adverseMediaReport": null,
        "amlReport": null,
        "metadata": {},
        "requestedBy": {
            "firstName": "API",
            "lastName": "User",
            "middleName": "",
            "id": "61d880f1e8e15aaf24558f1c"
        }
    },
    "links": []
}

Error Responses

  "success": false,
  "statusCode": 404,
  "message": "You have attempted to get a resource that does not exist.",
  "name": "ResourceNotFoundError",
  "data": {}
}