Initiate BVN Lookup
Last updated Nov 6th, 2025
post api.withmono.com/v2/lookup/bvn/initiatev1.0
Use this resource to initiate a BVN Consent request
Sandbox Credentials
Kindly retrieve your Sandbox test credentials from the Sandbox page here.
Scope
Kindly note that by default, scope is set to identity. To retrieve all accounts connected to a BVN,bank_accounts must be passed as scope.
Body Params
Headers
Request
12345678910
curl --request POST \
--url https://api.withmono.com/v2/lookup/bvn/initiate \
--header 'accept: application/json' \
--header 'content-type: application/json' \
--header 'mono-sec-key: string' \
--data '
{
"bvn":"string",
"scope":"string"
}'
Response
Choose an option from the drop down or click one of these buttons to see an example:
