mono-logo

Initiate Prove

Last updated March 17th, 2025

post api.withmono.com/v1/prove/initiate
v1.0

This 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

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.

Body Params
Headers

Request

123456789101112131415161718192021
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",
        "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:

Did this page help you?