Initiate Prove
Last updated August 25th, 2025
post api.withmono.com/v1/prove/initiateThis resource initiates a Mono Prove session, returning a Mono URL, ID, and other relevant details in the response. Your customers can access this URL via their browser, a web view in your mobile app, or the Mono Prove SDK.
The level of KYC verification required
tier_1: Validating only the BVN and NIN numbers and verifying ownership of the submitted identity numbers with facial recognition.
tier_2: Validating BVN, NIN, a government-issued identification document, and verifying ownership of the submitted document with facial recognition.
tier_3: Validating BVN, NIN, government ID, and address, verifying ownership of the submitted documents with facial recognition, and confirming the user resides at the provided address.
Request
curl --request POST \
--url https://api.withmono.com/v1/prove/initiate \
--header 'accept: application/json' \
--header 'content-type: application/json' \
--header 'mono-sec-key: string' \
--data '{
"customer": {
"name": "Samuel Olamide",
"phone": "08100110000",
"address": "Lagos State",
"email": "samuel@neem.co",
"identity": {
"number": "12345678901",
"type": "bvn"
}
},
"reference": "refId001",
"redirect_url": "http://mono.co",
"kyc_level": "tier_1",
"bank_accounts": false
}
'
Response
Choose an option from the drop down or click one of these buttons to see an example:
