Fetch Verification (Async)

Fetch Verification (Async)

POST {{BASE_URL}}/api/v1/verification

This endpoint allows you to verify a customer details asynchronously.

Headers

Name	Type	Description
Authentication*	String	Authentication token to identifer the api user.

Request Body

Name	Type	Description
identifier_type*	String	The identifier type being used for the verification (national_id)
identifier*	String	The identifier value
callback_url*	String	Callback url to send verification response to

200 Request successfully received.

{
   "status":202,
   "message":"Verification data fetch Process initiated",
   "data":{
      "reference_id":"b19234cc-2adf-4c1c-a6f8-91684254466c"
   }
}

JSON Payload

{
   "identifier_type":"national_id",
   "identifier":"21626048",
   "first_name": "Jane",
   "last_name": "Doe",
   "callback_url":"https://webhook.site/0f81808a-0134"
}

Callback Payload

{
   "status":200,
   "message":"Verification data successfully fetched",
   "reference_id":"b19234cc-2adf-4c1c-a6f8-91684254466c",
   "data":{
      "national_id":"21626048",
      "full_name":"MATHENGE ANTHONY KAMAU",
      "gender":"M",
      "surname":"MATHENGE",
      "date_of_birth":"01-02-1984",
      "other_names":"ANTHONY KAMAU"
   }
}