Identity Matching
Please note that when using your test key, Our test persona is John Doe and his BVN is 10000000001. Hence all matching done with your test keys with details other than our Test Persona would simulate a failed identity matching.
​
postIdentity Matching
post
https://vapi.verifyme.ng/v1/verifications/identities/bvn/:ref/match
Use this endpoint to match data supplied to bvn verified data
Request
Response
Request
Path Parameters
ref
required
string
BVN number
Headers
Authorization
required
string
Authorization Header
Body Parameters
firstname
required
string
First name
lastname
required
string
Last name
Response
200: OK
{"status": "success","data": {"firstname": "John","lastname": "Doe","bvn": "10000000001","fieldMatches": {"firstname": false,"lastname": false}}}
401: Unauthorized
{"statusCode": 401,"error": "Unauthorized"}
404: Not Found
{"code":"NOT_FOUND_ERROR","message":"BVN provided is not found. Please provide a valid bvn"}