Fetch BVN Details
Last updated Feb 20th, 2026
post api.withmono.com/v2/lookup/bvn/detailsv1.0
Use this resource to retrieve BVN Information requested
Body Params
Headers
Institution object fields (scope=bank_accounts)
| Field | Type | Description |
name | string | The official name of the financial institution. |
bank_code | string | The 3 to 5-digit code assigned by the CBN (e.g., 058, 00711). |
nip_code | string | The unique NIBSS Instant Payment identifier (e.g., 000013, 100004). |
branch | string | The internal branch identifier associated with the account. |
Implementation Note
If a bank is not yet mapped in our registry, the nip_code may return as null. In such cases, fall back to bank_code or institution.name for your internal logic.
Request
123456
curl --request POST \
--url https://api.withmono.com/v2/lookup/bvn/details \
--header 'accept: application/json' \
--header 'content-type: application/json' \
--header 'mono-sec-key: string' \
--data '{"otp":"string"}'
Response
Choose an option from the drop down or click one of these buttons to see an example:
