Initiate BVN Lookup
Last updated Nov 6th, 2025
post api.withmono.com/v2/lookup/bvn/initiateUse this resource to initiate a BVN Consent request
⚠️ Billing Notice: BVN Lookup
All BVN Lookup API requests are billable, including failed lookups (e.g. BVN not found or invalid).
To avoid unnecessary charges:
Validate BVNs before calling the API (BVNs must be 11-digit numeric values).
Avoid bulk or blind verification of unverified BVNs.
Implement throttling and monitor failed request rates.
If you need BVN Lookup temporarily disabled to prevent charges, contact your account manager or email support@mono.co
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.
Request
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:
