Verification ChecksVerificationsCV ingestion + AI analysis
Get a report
Retrieves the report you created with the CV ingestion + AI analysis call in this section — and any other report, whatever checks it ran. Use it to reconcile after a missed webhook, not as a substitute for one.
Scope: reports:read
The subject, lifecycle state, per-check results, risk score, and consent and payment state.
Reports run asynchronously. Rather than polling this, configure a
webhook for report.ready and report.failed — the
payload carries the finished checks, so
many integrations never need to call this at all.
AuthorizationBearer <token>
Use Authorization: Bearer vrf_live_... or vrf_test_....
In: header
Path Parameters
reportId*string
Report identifier.
Format
uuidResponse Body
application/json
application/problem+json
curl -X GET "https://example.com/api/v1/reports/497f6eca-6276-4993-bfeb-53cbbbba6f08"{ "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "status": "DRAFT", "subject": { "subjectType": "INDIVIDUAL", "fullName": "Jane Doe", "firstName": "string", "middleName": "string", "lastName": "string", "idNumber": "36901234", "registrationNumber": "PVT-7XUQ8KL", "email": "user@example.com", "phone": "+254712345678", "dateOfBirth": "2019-08-24", "country": "KE" }, "checksRequested": [ "CV_ANALYSIS" ], "checkResults": [ { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "checkName": "CV_ANALYSIS", "status": "PENDING", "summary": "string", "riskLevel": "LOW", "score": 0, "evidence": {}, "completedAt": "2019-08-24T14:15:22Z" } ], "riskScore": 0, "riskLevel": "LOW", "consentState": { "status": "NOT_REQUIRED", "consentUrl": "http://example.com", "expiresAt": "2019-08-24T14:15:22Z" }, "paymentState": { "status": "NOT_REQUIRED", "amount": { "amount": 0.1, "currency": "KES" }, "paidAt": "2019-08-24T14:15:22Z" }, "createdAt": "2019-08-24T14:15:22Z", "updatedAt": "2019-08-24T14:15:22Z"}