Skip to main content
POST
/
bvn
/
verifications
Initiate BVN Consent
curl --request POST \
  --url https://api.flutterwave.com/v3/bvn/verifications \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "bvn": "22222222280",
  "firstname": "Nibby",
  "lastname": "Certifier",
  "redirect_url": "https://example-url.company.com"
}
'
{
  "status": "success",
  "message": "Bvn verification initiated",
  "data": {
    "url": "https://nibss-bvn-consent-management.dev-flutterwave.com/cms/BvnConsent?session=ZDdiYjVjODMtYWE0My00NjI0LTllMjAtYTQyODBmMzI1NmQ5",
    "reference": "FLWA968D23A3D2BE31F5D63D0"
  }
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
​
bvn
string
required
​
firstname
string
required
​
lastname
string
required
​
redirect_url
string
required

Response

OK

​
status
string
required
​
message
string
required
​
data
Data89 · object
required
Example:
{
  "url": "https://nibss-bvn-consent-management.dev-flutterwave.com/cms/BvnConsent?session=ZDdiYjVjODMtYWE0My00NjI0LTllMjAtYTQyODBmMzI1NmQ5",
  "reference": "FLWA968D23A3D2BE31F5D63D0"
}