Identity Verification

This service enables identity verification across various ID types such as Driver's license, NIN, BVN and International passport.

This endpoint verifies identity details such as :-

  1. first name
  2. last name
  3. Address
  4. phone number
  5. date of birth
  6. Anti money laundry (AML)
  7. Bank account number
  8. bank code

Process Flow

Step one :- Make a POST request to Verification endpoint.

🚧

Please note

The type field should be set to INDIVIDUAL. The verificationRequests field is an array that carries the various identification types and their related values.

Sample Request

curl  https://kyc-service.k8.isw.la/api/v1/verifications \
-H "Authorization: Bearer <token>" \
-H "Content-Type: application/json" \
-d '{
    "type": "INDIVIDUAL",
    "phone": "08030000000",
    "lastName": "Doe",
    "firstName": "John",
    "birthDate": "1990-01-01",
    "verificationRequests": [
            {
                "type": "ADDRESS",
                "buildingNumber": "15B",
                "street": "Oko Awo Street",
                "landmark": "Eko Hotel",
                "city": "Victoria Island"
                "state": "NG-LA",
                "country": "NGA",
                "base64EncodedImage": "/9j/4AAQSkZJRgABAQEASABIAAD//gBcYm9yZGVyIGJzOjAgYmM6IzAwMDAwMCBwczowIHBjOiNlZWVlZWUgZXM6MCBlYzojMDAwMDAwIGNrOjUwMGQwMmE0ZjFmMWQ3NDk3MzQwY2M1ODY4OTZiZjEx/9sAQwAGBAUGBQQGBgUGBwcGCAoQCgoJCQoUDg8MEBcUGBgXFBYWGh0lHxobIxwWFiAsICMmJykqKRkfLTAtKDAlKCko/9sAQwEHBwcKCAoTCgoTKBoWGigoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgo/8AAEQgAGQAZAwEiAAIRAQMRAf/EABgAAQADAQAAAAAAAAAAAAAAAAcEBQYI/8QAMRAAAgECBAQEAgsAAAAAAAAAAQIDBBEABQYSByExQRMUIlEVczI2YWJxcpGTsbLC/8QAFgEBAQEAAAAAAAAAAAAAAAAAAgME/8QAHREAAQUAAwEAAAAAAAAAAAAAAQACAwQREyEiMf/aAAwDAQACEQMRAD8AvuJPGqo0trd9MZZp1qidCiNV1cjRoWcCxVQvNBceq/Pn+OMtFrYfHJqTV1I1JVs1jVbyyqe28AEhelmUkWt6SOYbOONXDRcP2jrL+VqauGKRhzKAN4gKjudyKLfbgyjoNMapmarcJVNTRKiwvuVlFjtuORHL39sRfYMLlpjottRnT2q3I9Z1eU8QsgytJoJaWsZaasjp5N8bNKwWN1IuLg7TuHVW/R48I4EuHOkcqqtWxZzFEhnaqM9LAG2JTww7VLBB1Jaxv95e/PDnY4Yl5fQUpKxrYwnVA4uZM2p9CZhk9FLTLmMjQy04mJsHSRXHQEi4Ui9u+OZpct1lUZjPl9ZFDSeUJpGnEgbaqsVIS3Nu9rjucdXZZ9E/NP8AbB1qf635l8wfwcRsnG6tVEFzi3elUcJcuqMq1E0NPRGeGSjMTylvVCqnde563Jtblzt7YT/Ow+037bYi8Nutf+VP9Y0uFVGxglG9nMQBnxf/2Q=="
            },
            {
                "type": "AML",
                "country": "NGA"
            },
            {
                "type": "BVN",
                "identityNumber": "11111111111"
            },
            {
                "type": "DRIVERS_LICENCE",
                "identityNumber": "AAA22222A01",
                "country": "XXX"
            },
            {
                "type": "NIN",
                "identityNumber": "33333333333",
                "documents": [
                    {
                        "fileName": "fNW12s8fXEwexxIM71weMQeu4.png",
                        "description": "NIMC Slip"
                    }
                ]
            },
            {
                "type": "PASSPORT",
                "identityNumber": "A44444444"
            },
            {
                "type": "BANK_ACCOUNT",
                "accountNumber": "0696363603",
                "bankCode": "044",
                "country": "NGA"
            }
        ],
    "callbackUrl": "http://localhost:8080"
}' 
-X POST

Sample Response

{
    "verificationResponses": [
        {
            "type": "ADDRESS",
            "status": "PENDING",
            "lastName": "Doe",
            "firstName": "John",
            "birthDate": "1990-01-01",
            "phone": "+2348030000000",
            "buildingNumber": "15B",
            "street": "Oko Awo Street",
            "landmark": "Eko Hotel",
            "city": "Victoria Island",
            "state": "Lagos",
            "country": "Nigeria",
            "reference": "ISW|KYC|ADD|20200122|P64JHM1H7"
        },
        {
            "type": "AML",
            "status": "NO MATCH",
            "kycDomain": "ISW",
            "amlMatches": [],
            "reference": "ISW|KYC|AML|20200122|09390527R"
        },
        {
            "type": "BVN",
            "status": "VERIFIED",
            "identityNumber": "11111111111",
            "lastName": "Doe",
            "firstName": "John",
            "birthDate": "1990-01-01",
            "reference": "ISW|KYC|BVN|20200122|5ZSOLLU1V"
        },
        {
            "type": "DRIVERS LICENCE",
            "status": "FAILED",
            "reference": "ISW|KYC|DLN|20200122|C1S7BGOUX",
            "failureCode": "bad_request",
            "failureDescription": "Request is not valid. Possible syntax, data type mismatch, or field validation errors",
            "errors": [
                {
                    "field": "country",
                    "message": "invalid - expected: iso alpha-3 country code"
                }
            ]          
        },
        {
            "type": "NIN",
            "status": "NOT VERIFIED",
            "identityNumber": "33333333333",
            "lastName": "Doe",
            "firstName": "John",
            "birthDate": "1990-01-01",
            "reference": "ISW|KYC|NIN|20200122|P4R9SLNMA"
        },
        {
            "type": "PASSPORT",
            "status": "FAILED",
            "reference": "ISW|KYC|PPT|20200122|FLL3THDBE",
            "failureCode": "bad_request",
            "failureDescription": "Request is not valid. Possible syntax, data type mismatch, or field validation errors",
            "errors": [
                {
                    "field": "country",
                    "message": "required"
                }
            ]          
        },
        {
            "type": "BANK ACCOUNT",
            "status": "NOT VERIFIED",
            "country": "Nigeria",
            "reference": "ISW|KYC|BAC|20200511|MAEI5JMVB"
        }
    ]
}

📘

Reference

Individual and Corporate Verification