API ReferenceDeveloper ConsoleDeveloper Community

Identity Verification

Suggest Edits

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

Updated 5 months ago