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

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

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

This endpoint is protected by OAuth 2.0 Bearer Token

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"
}

...