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
{
"status":202,
"message":"Verification data fetch Process initiated",
"data":{
"reference_id":"b19234cc-2adf-4c1c-a6f8-91684254466c"
}
}
{
"identifier_type":"national_id",
"identifier":"21626048",
"first_name": "Jane",
"last_name": "Doe",
"callback_url":"https://webhook.site/0f81808a-0134"
}
{
"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"
}
}
Last updated
Was this helpful?