Identity verification

This endpoint allows you to verify identities for BVN, NIN, Passport, Drivers License and PVC.

POST

{{baseurl}}/v1/identities/candidates/check

Header

Field	Type	Description
token	String	API secret token

Parameter

Field	Type	Description
report_typeoptional	String	Report type Default value: identity
reference	String	Identity number. One of BVN, NIN, Passport, Drivers License and PVC
type	String	Must be one of ibvn, passport, inec, frsc, nin, nin_facial, bvn_facial or passport_facial
subject_consent	Boolean	Indicate subject has given consent. Must be true
last_name	String	last name of subject. required for passport and passport_facial and optional for other IDs
first_nameoptional	String	firstname of subject
middle_nameoptional	String	middlename of subject
doboptional	String	date of birth
image	String	Base64 or Image URL to compare ID image with. Required for type of bvn_facial, nin_facial and passport_facial

BVN check Request

{
    "report_type": "identity",
    "type": "ibvn",
    "reference": "20202xxxxxx",
    "first_name": "Famous",
    "middle_name": "",
    "last_name": "Ehichioya",
    "dob": "1988-04-04",
    "subject_consent": true
}

Drivers License Check Request

{
    "report_type": "identity",
    "type": "frsc",
    "reference": "SMK862xxxxxx",
    "first_name": "Famous",
    "middle_name": "",
    "last_name": "Ehichioya",
    "dob": "1998-04-04"
}

Passport Check Request

{
    "report_type": "identity",
    "type": "passport",
    "reference": "A07xxxxxx",
    "first_name": "Famous",
    "middle_name": "",
    "last_name": "Ehichioya",
    "dob": "1988-04-04"
}

Voters Card Check Request

{
    "report_type": "identity",
    "type": "inec",
    "reference": "90F5AFA35D2xxxxxxxx",
    "first_name": "Famous",
    "middle_name": "",
    "last_name": "Ehichioya",
    "dob": "1988-04-04"
}

NIN Check Request

{
    "report_type": "identity",
    "type": "nin",
    "reference": "90645xxxxxx",
    "first_name": "Famous",
    "middle_name": "",
    "last_name": "Ehichioya",
    "dob": "1988-04-04"
}

Passport Facial Request

{
    "report_type": "identity",
    "type": "passport_facial",
    "reference": "A11xxxxxx",
    "last_name": "Ehichioya",
    "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQEAkACQAAD/4Q",
    "subject_consent": true
}

BVN Facial Request

{
    "report_type": "identity",
    "type": "bvn_facial",
    "reference": "21234xxxxxx",
    "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQEAkACQAAD/4Q",
    "subject_consent": true
}

NIN Facial Request

{
    "report_type": "identity",
    "type": "nin_facial",
    "reference": "602134xxxxx",
    "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQEAkACQAAD/4Q",
    "subject_consent": true
}

Sample Responses for each verification

BVN Response

HTTP/1.1 200 OK
{
        "message": "Successful",
        "data": {
            "id": "61f5e0f6d656e7d19b78779a",
            "type": "ibvn",
            "task_created_by": "Youcheck Online Services Limited",
            "reference_id": "223286xxxxxx",
            "status": "found",
            "response": {
                "first_name": "FAMOUS",
                "middle_name": "PRIOR",
                "mobile": "08036xxxxxx",
                "last_name": "EHICHIOYA",
                "dob": "1988-04-04",
                "photo": "data:image/jpg;base64,/9j/4AAQSkZJRgABAgAAAQABAAD/2wBDAAgGBgcGBQgHBwcJCQgKDBQNDAsLDBkSEw8U",
                "subject_consent": true,
                "reference_id": "223286xxxxxx",

            }
        },
        "status_code": 200
    }

NIN Response

HTTP/1.1 200 OK
   {
    "message": "Successful",
    "data": {
        "id": "61f6d647911ad409d27f2b62",
        "type": "nin",
        "task_created_by": "Youcheck Online Services Limited",
        "reference_id": "90899xxxxxx",
        "status": "found",
        "response": {
            "first_name": "FAMOUS",
            "last_name": "EHICHIOYA",
            "middle_name": "PRIOR",
            "dob": "1988-04-04",
            "mobile": "08036xxxxxx",
            "reference_id": "90899xxxxxx",
            "batch_id": null,
            "birth_country": "nigeria",
            "birth_lga": "Suleja",
            "birth_state": "Niger",
            "card_status": null,
            "central_id": null,
            "document_no": null,
            "educational_level": null,
            "employment_status": null,
            "gender": "male",
            "height": null,
            "maiden_name": null,
            "marital_status": null,
            "nok_address1": "****",
            "nok_address2": "",
            "nok_firstname": "****",
            "nok_lga": "****",
            "nok_state": "****",
            "nok_surname": "****",
            "nok_town": "****",
            "ospokenlang": "****",
            "photo": "data:image/jpg;base64,/9j/4AAQSkZJRgABAgAAAQABAAD/2wBDAAgGBgcGBQgHBwcJCQgKDBQN",
            "religion": "christianity",
            "residence_address_line1": "OPPOSITE SULEIMAN BARAU TECHNICAL COLLEGE KWAMBA.",
            "residence_town": null,
            "residence_lga": "SULEJA",
            "residence_state": "Niger",
            "self_origin_lga": "Suleja",
            "self_origin_place": "****",
            "self_origin_state": "Niger",
            "signature": "data:image/jpg;base64,/9j/4AAQSkZJRgABAQEAlgCWAAD/2wBDAAgGBgcGBQgHBwc",
            "tracking_id": null
        }
    },
    "status_code": 200
}

PVC Response

HTTP/1.1 200 OK
{
        "message": "Successful",
        "data": {
            "id": "61f6d5bc2257380884db81ba",
            "type": "inec",
            "task_created_by": "Youcheck Online Services Limited",
            "reference_id": "90F5AFA35D2xxxxxxxx",
            "status": "found",
            "response": {
                "first_name": "FAMOUS",
                "last_name": "EHICHIOYA",
                "middle_name": "PRIOR",
                "dob": "1968-07-24",
                "mobile": null,
                "reference_id": "90F5AFA35D2xxxxxxxx"
            }
        },
        "status_code": 200
    }

Passport Response

HTTP/1.1 200 OK
{
        "message": "Successful",
        "data": {
            "id": "61f6d72e6475780b91eda6c0",
            "type": "passport",
            "task_created_by": "Youcheck Online Services Limited",
            "reference_id": "A07xxxxxx",
            "status": "found",
            "response": {
                "first_name": "FAMOUS",
                "last_name": "Ehichioya",
                "middle_name": "PRIOR",
                "dob": "1966-02-04",
                "mobile": null,
                "photo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAPAAAAFACAYAAACC6PFTA",
                "gender": "male",
                "issued_at": "MINNA",
                "issued_date": "2016-02-23T00:00:00.000Z",
                "expiry_date": "2021-02-22T00:00:00.000Z",
                "reference_id": "A07xxxxxx"
            }
        },
        "status_code": 200
    }

Drivers License Response

HTTP/1.1 200 OK
{
        "message": "Successful",
        "data": {
            "id": "61f69b1957d422f1152bb745",
            "type": "frsc",
            "status": "found",
            "task_created_by": "Youcheck Online Services Limited",
            "reference_id": "SMK862xxxxxx",
            "response": {
                "residence_address_line1": null,
                "residence_town": null,
                "residence_lga": null,
                "residence_state": null,
                "application_first_issued_date": null,
                "application_issued_date": "2021-05-26T00:00:00.000Z",
                "application_expiry_date": "2026-04-04T00:00:00.000Z",
                "state_of_issuance": "LAGOS",
                "dob": "1968-04-04",
                "photo": "data:image/jpg;base64,/9j/4AAQSkZJRgABAQEAYABgAAD/2wBDAAgGBgcGBQ...",
                "disability": null,
                "facial_mark": null,
                "first_state_of_issuance": null,
                "first_name": "FAMOUS",
                "gender": "male",
                "glasses": null,
                "height": null,
                "self_origin_lga": null,
                "license": {
                    "class": null,
                    "description": null
                },
                "mobile": null,
                "maiden_name": null,
                "birth_country": null,
                "next_of_kin_phone_number": null,
                "middle_name": null,
                "previous_dl_number": null,
                "birth_state": null,
                "last_name": "EHICHIOYA",
                "subject_consent": true,
                "reference_id": "SMK862xxxxxx",

            }
        },
        "status_code": 200
    }

Passport Facial Response

HTTP/1.1 200 OK
{
        "message": "Successful",
        "data": {
            "id": "61fb70e7dc1549da244670e2",
            "type": "passport_facial",
            "task_created_by": "Youcheck Online Services Limited",
            "reference_id": "A111xxxxx",
            "status": "found",
            "response": {
                "first_name": "FAMOUS",
                "last_name": "EHICHIOYA",
                "middle_name": "PRIOR",
                "dob": "20001-01-01",
                "mobile": null,
                "photo": "data:image/jpg;base64,/9j/4AAQSkZJRgABAgEAAAAAAAD//gASSVJJUyBKUEVHIENPREV",
                "gender": "male",
                "issued_at": "IKOYI",
                "issued_date": "2020-02-04T00:00:00.000Z",
                "expiry_date": "2025-02-03T00:00:00.000Z",
                "reference_id": "A111xxxxx",
                "face_details": {
                    "confidence": 87,
                    "threshold": 70,
                    "request_image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQEAkACQAAD/4QDARXhpZgAASUkqA"
                }
            }
        },
        "status_code": 200
    }

BVN Facial Response

HTTP/1.1 200 OK
{
        "message": "Successful",
        "data": {
            "id": "61fb74374999a6ded6e0b688",
            "type": "bvn_facial",
            "task_created_by": "Youcheck Online Services Limited",
            "reference_id": "22328xxxxxx",
            "status": "found",
            "response": {
                "first_name": "FAMOUS",
                "middle_name": "PRIOR",
                "mobile": "080362xxxxx",
                "last_name": "EHICHIOYA",
                "dob": "1956-04-04",
                "photo": "data:image/jpg;base64,/9j/4AAQSkZJRgABAgAAAQABAAD/2wBDAAgGBgcGBQgHBwcJCQgKDBQND",
                "subject_consent": true,
                "reference_id": "22328xxxxxx",
                "face_details": {
                    "confidence": 59,
                    "threshold": 70,
                    "request_image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQEAkACQAAD/4QDARXhpZgAASUkqAA"
                }
            }
        },
        "status_code": 200
    }

NIN Facial Response

HTTP/1.1 200 OK
{
        "message": "Successful",
        "data": {
            "id": "61fb7301bd88acdd22c8fbd5",
            "type": "nin_facial",
            "task_created_by": "Youcheck Online Services Limited",
            "reference_id": "90899xxxxxx",
            "status": "found",
            "response": {
                "first_name": "FAMOUS",
                "last_name": "EHICHIOYA",
                "middle_name": "PRIOR",
                "dob": "1960-04-04",
                "mobile": "08036xxxxxx",
                "reference_id": "90899xxxxxx",
                "batch_id": null,
                "birth_country": "nigeria",
                "birth_lga": "Suleja",
                "birth_state": "Niger",
                "card_status": null,
                "central_id": null,
                "document_no": null,
                "educational_level": null,
                "employment_status": null,
                "gender": "male",
                "height": null,
                "maiden_name": null,
                "marital_status": null,
                "nok_address1": "****",
                "nok_address2": "",
                "nok_firstname": "****",
                "nok_lga": "****",
                "nok_state": "****",
                "nok_surname": "****",
                "nok_town": "****",
                "ospokenlang": "****",
                "photo": "data:image/jpg;base64,/9j/4AAQSkZJRgABAgAAAQABAAD/2wBDAAgGBgcGBQgHBwcJCQgKDBQND",
                "religion": "christianity",
                "residence_address_line1": "OPPOSITE SULEIMAN BARAU TECHNICAL COLLEGE KWAMBA.",
                "residence_town": null,
                "residence_lga": "SULEJA",
                "residence_state": "Niger",
                "self_origin_lga": "Suleja",
                "self_origin_place": "****",
                "self_origin_state": "Niger",
                "signature": "data:image/jpg;base64,/9j/4AAQSkZJRgABAQEAlgCWAAD/2wBDAAgGBgcGBQgHBwcJCQgK",
                "tracking_id": null,
                "face_details": {
                    "confidence": 55,
                    "threshold": 70,
                    "request_image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQEAkACQAAD/4QDARXhpZgAASUkqAAgAAAAFA"
                }
            }
        },
        "status_code": 200
    }

Not Found Response

HTTP/1.1 404 Not Found
      {
            "message": "No Result was found",
            "name": "LegacyAPIError",
            "status_code": 404
      }

Service Unavailable

HTTP/1.1 503 Internal Server Error
{
    "message": "Third-party provider not reacheable",
    "name": "LegacyAPIError",
    "status_code": 503
}

HTTP/1.1 400 Bad Request
{
  "message": "Could not resolve account name. Check parameters or try again.",
  "name": "LegacyAPIError",
  "status_code": 400
}