Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

For name, a slightly advanced comparison is done and you can get one of three statuses: FULL_MATCH, PARTIAL_MATCH, NO_MATCH.

Info

Price

This service costs N10 for each successful request.

Info

Endpoint:

...

This endpoint is protected with OAuth 2.0 Bearer token. To find out more about authorization for Monnify endpoints, check Here

Endpoint URL: https://api.monnify.com/api/v1/vas/bvn-details-match

This endpoint is protected with Basic Authentication

HTTP Method: POST

Info

Please note that the BVN samples used in this documentation are not real and are just indicative of how the API should be used

Scenario 1: Bank Verification Number is not valid

...

Sample Response:

Code Block
languagejson
{
    "requestSuccessful": false,
    "responseMessage": "Unable to process request. Invalid BVN provided",
    "responseCode": "99"
}

...

Sample Request:

Code Block
languagejson
{
	"bvn":"22222222226",
    "name": "Benjamin Ranae RT",
    "dateOfBirth": "03-Oct-1993",
    "mobileNo": "08016857829"
}

...

Sample Request:

Code Block
languagejson
{
	"bvn":"22222222226",
    "name": "OLATUNDE JOSIAH",
    "dateOfBirth": "03-Oct-1993",
    "mobileNo": "08016857829"
}

...

Sample Request:

Code Block
languagejson
{
	"bvn":"22222222226",
    "name": "OLATUNDE JOSIAH OGUNBOYEJO",
    "dateOfBirth": "27-Apr-1993",
    "mobileNo": "08142223149"
}

...