BVN Validation Status
Get status of BVN validation
AUTHORIZATION
Authorization: IP Check and Header authorization/bearer token.
The authorization details will be shared privately.
Request Method: GET
Request URL:
Request Payload: Query string
{
"ref" : "a76ce6Tz11Pq"
}
Response: Content-Type: application/json
Success Response Body:
{
"flag" : true,
"auth" : true,
"msg" : "Data retrieved",
"data" : "payload": [
{
"bvn": "21234123456",
"phone": "07034477723",
"email": "[email protected]",
"status": "Success",
"bvn_data":
{
"customer_id" : "",
"enroll_user_name" : "",
"gender" : "",
"title" : "",
"surname" : "",
"first_name" : "",
"middle_name" : "",
"date_of_birth" : "",
"face_image" : "",
"lga_of_origin" : "",
"marital_status" : "",
"nationality" : "",
"nin" : "",
"remarks" : "",
"state_of_origin" : "",
"additional_info_1" : "",
"watchlisted" : "",
}
},
{
"bvn": "21234123457",
"phone": "07034477723",
"email": "[email protected]",
"status": "Failed",
"reason": "User declined to give consent"
},
{
"bvn": "21234123457",
"phone": "07034477723",
"email": "[email protected]",
"status": "Pending"
},
{...}, ]
}
Success Response Description:
The response is JSON and contains the following: flag (Bool), auth (Bool), msg (String) and data (Object). The data is an Object a status status (String) of the request which can be either success, failed or pending.
Error Response Body:
{
"flag" : false,
"auth" : false,
"msg" : "Not authorized",
"data" : {}
}
Error Response Description:
Possible cause of error:
- Failed authentication,
- Server downtime
Updated over 2 years ago