Initiate BVN Consent

Request consent for BVN verification

POST /bvn/verifications

Initiate BVN Consent

cURL

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"
}
'

200

{
  "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

200

application/json; charset=utf-8

OK

status · string · required

message · string · required

data · Data89 · object · required

Show child attributes

Example:

{
  "url": "https://nibss-bvn-consent-management.dev-flutterwave.com/cms/BvnConsent?session=ZDdiYjVjODMtYWE0My00NjI0LTllMjAtYTQyODBmMzI1NmQ5",
  "reference": "FLWA968D23A3D2BE31F5D63D0"
}