Verification ChecksEmployment & education
Certificate of good conduct verify
Verify certificate of good conduct evidence.
Send CERT_GOOD_CONDUCT in checksRequested to run this check.
Upload the certificate before creating the report.
The request
{
"subject": {
"fullName": "Jane Doe",
"idNumber": "36901234",
"email": "jane@example.com",
"country": "KE",
"subjectType": "INDIVIDUAL"
},
"checksRequested": [
"CERT_GOOD_CONDUCT"
],
"attachments": [
{
"checkType": "CERT_GOOD_CONDUCT",
"documentId": "7f000001-a1b0-1000-81a1-b00000000102"
}
],
"purpose": "Employment screening",
"consent": {
"mode": "VERIFISHA_HOSTED"
}
}The acknowledgement
Creation is asynchronous. The report comes back as a draft; the check runs after.
{
"reports": [
{
"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"status": "DRAFT",
"paymentState": {
"status": "NOT_REQUIRED",
"amount": {
"amount": 0.1,
"currency": "KES"
}
},
"consentState": {
"status": "NOT_REQUIRED"
}
}
],
"count": 1
}The result
When the check finishes, this arrives at your webhook. COMPLETED means it
ran — read riskLevel and flags to decide what it found.
Related
- Run a Verification — this check's endpoints, with a playground
- Webhooks — the delivery, its headers and signature
- Statuses and outcomes — what the result means
GET /checks/definitions— price, inputs and availability for your workspace