Verify Old National ID

Old CIV ID Verification

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

This endpoint allows you to perform different types of the old 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
selfie	Object	Selfie validation object
image	String	Selfie image URL

Old CIV ID Verification

Old CIV ID Verification Sample Request

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

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

Old CIV ID Validation

Old CIV ID Validation Sample Request

{
    "id": "C0117721704",
    "isSubjectConsent": true,
    "validations": {
        "data": {
            "lastName": "BADOU",
            "firstName": "BOA JEAN-LOUIS STEVe",
            "dateOfBirth": "1999-05-26"
        },
        "selfie": {
            "image": "https://youverify-cdn.fra1.digitaloceanspaces.com/1764798098627-kqocQptDzZ3oT40JllGNd.jpg"
        }
    }
}

Old CIV ID Validation Sample Response

{
    "success": true,
    "statusCode": 200,
    "message": "success",
    "data": {
        "id": "6929ab1ed4f3a3f47146cf56",
        "validations": {
            "data": {
                "lastName": {
                    "validated": false,
                    "value": "BADOU"
                },
                "dateOfBirth": {
                    "validated": true,
                    "value": "1999-05-26"
                },
                "firstName": {
                    "validated": false,
                    "value": "BOA JEAN-LOUIS STEVe"
                }
            },
            "selfie": {
                "selfieVerification": {
                    "confidenceLevel": 97,
                    "threshold": 80,
                    "match": true,
                    "image": "https://youverify-cdn.fra1.digitaloceanspaces.com/1764798098627-kqocQptDzZ3oT40JllGNd.jpg"
                }
            },
            "validationMessages": "First name does not match, Last name does not match"
        },
        "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": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQEASABIAAD...",
        "nationality": "CIV",
        "dateOfBirth": "1999-05-26",
        "isConsent": true,
        "idNumber": "C0117721704",
        "businessId": "61d880f1e8e15aaf24558f1a",
        "type": "ciOldNationalId",
        "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": {}
}