Given validation type and validation ID, and other details itemized in the table below, confirm that a person exist on the KYC platform. The system will confirm the details specified in the request body,  and will also return a response with details based on the validation on the platform.

Base URL: https://api-gateway.interswitchng.com/isw-data-service

Request Body Fields

SN	Field Name	Data Type	Max Length / Format	Required	Description
2	validationType	String		YES	The type of identification means that is been used to verify the individual, can be one of either NIN, BVN
3	validationId	String		Yes	The unique identification number for that validationType that should point to that unique individual being verified
4	firstname	String		Yes	The firstName of the individual to be vetted against the firstName of the validation ID holder on the KYC platform
5	lastname	String		Yes	The lastName of the individual to be vetted against the lastName of the validation ID holder on the KYC platform
6	birthDate	Date	yyyy-MM-dd	Yes	The date of birth of the individual to be vetted against the date of birth of the validation ID holder on the KYC platform
7	gender	String		Yes	The gender of the individual to be vetted against the gender of the validation ID holder on the KYC platform
8	phone	String		Yes	The phone number of the individual to be vetted against the phone number of the validation ID holder on the KYC platform

Request URL: {{baseurl}}/api/v1/request/verification

Request Headers

HTTP Method: POST

Content-Type: application/json

Authorization: Bearer Token

Sample Request

{

"firstname": "john",
"lastname": "doe",
"birthDate": "1990-01-01",
"gender": "male",
"phone": "08030000000",
"validationType": "BVN",
"validationId": "11111111111"
}

Sample Response

{
"responseCode": "00",
"responseMessage": Successful,
"data": {
"type": "BVN",
"status": "VERIFIED",
"identityNumber": "11111111111",
"lastName": "Doe",
"firstName": "John",
"birthDate": "1990-01-01",
"reference": "ISW|KYC|BVN|20200714|WFWVVCSBI"
}
}