KYC - Kenya
Verify KRA PIN
Look up a Kenya Revenue Authority (KRA) PIN using a taxpayer national ID.
POST
/
v2
/
api
/
identity
/
ke
/
kra-pin
curl --request POST \
--url https://api.youverify.co/v2/api/identity/ke/kra-pin \
--header 'Content-Type: application/json' \
--header 'token: <api-key>' \
--data '
{
"id": "12345678",
"isSubjectConsent": true
}
'
{
"success": true,
"statusCode": 200,
"message": "success",
"data": {
"id": "6416e5258c8eb062f325a87c",
"parentId": null,
"status": "found",
"reason": null,
"dataValidation": false,
"selfieValidation": false,
"pin": "A123456789Z",
"pinStatus": "Active",
"taxpayerName": "JOHN DOE SAMPLE",
"taxpayerType": "Individual",
"isConsent": true,
"businessId": "628b38f03ae28a14f52d4bf7",
"type": "keKraPin",
"allValidationPassed": true,
"idNumber": "12345678",
"requestedAt": "2023-03-19T10:34:14.297Z",
"requestedById": "628b38f03ae28a5a122d4bf3",
"country": "KE",
"createdAt": "2023-03-19T10:34:14.485Z",
"lastModifiedAt": "2023-03-19T10:34:14.485Z",
"metadata": {},
"requestedBy": {
"firstName": "API",
"lastName": "User",
"middleName": "",
"id": "628b38f03ae28a5a122d4bf3"
}
},
"links": []
}
Authorizations
Your Youverify API secret key. Never expose client-side.
Headers
API secret token
Body
application/json
Response
Success
⌘I
curl --request POST \
--url https://api.youverify.co/v2/api/identity/ke/kra-pin \
--header 'Content-Type: application/json' \
--header 'token: <api-key>' \
--data '
{
"id": "12345678",
"isSubjectConsent": true
}
'
{
"success": true,
"statusCode": 200,
"message": "success",
"data": {
"id": "6416e5258c8eb062f325a87c",
"parentId": null,
"status": "found",
"reason": null,
"dataValidation": false,
"selfieValidation": false,
"pin": "A123456789Z",
"pinStatus": "Active",
"taxpayerName": "JOHN DOE SAMPLE",
"taxpayerType": "Individual",
"isConsent": true,
"businessId": "628b38f03ae28a14f52d4bf7",
"type": "keKraPin",
"allValidationPassed": true,
"idNumber": "12345678",
"requestedAt": "2023-03-19T10:34:14.297Z",
"requestedById": "628b38f03ae28a5a122d4bf3",
"country": "KE",
"createdAt": "2023-03-19T10:34:14.485Z",
"lastModifiedAt": "2023-03-19T10:34:14.485Z",
"metadata": {},
"requestedBy": {
"firstName": "API",
"lastName": "User",
"middleName": "",
"id": "628b38f03ae28a5a122d4bf3"
}
},
"links": []
}