Skip to main content

​
Verify your customers’ identity using their Alien Identification

Adhere’s Alien Identification endpoint allows you to access accurate, verified national-level information for reliable identity confirmation.

​
Request Endpoint

POST {{BASE_URL}}/api/onboarding/kenya_kyc/alien_id/
  • Media-Type: application/json

​
Status Codes

  • 200 OK: The request was successful, and the customer’s information is returned successfully.
  • 400 Bad Request: The request could not be completed due to invalid or missing information.

​
Sample Payload

{
    "alien_id": "1000000"
}
200 OK Response 
{
    "status": "success",
    "data": {
        "valid": true,
        "id_number": "1000000",
        "first_name": "JAMES",
        "last_name": "KARIUKI",
        "middle_name": "MWANGI",
        "date_of_birth": "1990-04-15",
        "gender": "Male",
        "nationality": "Ugandan"
    },
    "message": "Alien ID details retrieved successfully"
}
400 Bad Request Response 
{
    "status": "failed",
    "data": [],
    "message": "Sorry, your check cannot be processed at the moment. Please try again in a few minutes"
}