BudPay

Popular Searches:
Identity Verification

BVN Verification

Verify BVN

Get the bvn details match on any bvn number.

Endpoint: /bvn/verify
Method: POST

Header

Param Type Required? Decription
authorization string Yes Set value to Bearer SECRET_KEY
content-type string Yes Set value to application/json

Body Param

Param Type Required? Decription
bvn string Yes bvn to verify (use 00000000000 in test mode)
callback_url string Yes your callback url to get verification response
first_name string No bvn firstname
middle_name string No bvn middlename
last_name string No bvn lastname
phone_number string No bvn phone number
dob string No bvn date of birth (YYYY-MM-DD)
gender string No bvn user gender
reference string No your unique reference number (we will generate one automatically if not provided)

Sample Post

                            
                                curl https://api.budpay.com/api/v2/bvn/verify
                                -H "Authorization: Bearer YOUR_SECRET_KEY"
                                -H "Content-Type: application/json"
                                -d '{
                                        "bvn": "00000000000",
                                        "first_name": "Tolulope",
                                        "middle_name": "Samuel",
                                        "last_name": "Segun",
                                        "phone_number": "08011111111",
                                        "dob": "1972-12-03",
                                        "gender": "Male",
                                        "reference": "20220540300003938",
                                        "callback_url": "http://your_webhook_url"
                                    }'
                                -X POST
                            
                        

Sample Response

                            
                            {
                                "success": true,
                                "message": "Request Submitted Successfully",
                                "reference": "20220540300003938"
                            }