QOqoreid

BVN (Basic)

Changed on

Verify a customer's identity using their Bank Verification Number (BVN) through the Nigeria Inter-Bank Settlement System (NIBSS)

post/v1/ng/identities/bvn-basic/{bvnNumber}

Request

  • Base URL
    https://api.qoreid.com
  • URL
    https://api.qoreid.com/v1/ng/identities/bvn-basic/{bvnNumber}
  • Auth
    OAuth 2

Path parameters

bvnNumberstring required

individual's bvn number

Query parameters

isBvnIgreeboolean

Use is params only to test Bvn iGree

Request body

firstnamestring required

Firstname

lastnamestring required

Last Name

dobstring

Date Of Birth

phonestring

Phone Number

emailstring

Email Address

genderstring

Gender

Response

200

idinteger

Example response

{
  "id": 157,
  "applicant": {
    "firstname": "Bunch",
    "lastname": "Dillon"
  },
  "summary": {
    "bvn_check": {
      "status": "EXACT_MATCH",
      "fieldMatches": {
        "firstname": true,
        "lastname": true
      }
    }
  },
  "status": {
    "state": "complete",
    "status": "verified"
  },
  "bvn": {
    "bvn": "95888168924",
    "firstname": "Bunch",
    "lastname": "Dillon",
    "birthdate": "07-07-1995",
    "gender": "Male",
    "phone": "08000000000",
    "photo": "/9j/4AAQSkZJRgABAgAAAQABAAD/***/wCpiNUFoooEf//Z"
  }
}

Changes