Prompt
kyc api manual review
Latest observation
Oct 29, 2026
OpenAI APIWeb search: off
If you want to add manual review to a KYC API flow, the usual pattern is:
Typical flow
- User submits KYC data/documents
- API runs automatic checks
- document validity
- face match
- liveness
- sanctions/PEP screening
- address/name verification
- If rules fail or confidence is low, status becomes
manual_review - A compliance agent reviews the case in a dashboard
- Agent outcome updates status to:
approvedrejectedneeds_more_info
Common API statuses
pendingin_reviewmanual_reviewapprovedrejectedresubmission_required
Example endpoints
POST /kyc/applications— create KYC caseGET /kyc/applications/{id}— check current statusPOST /kyc/applications/{id}/documents— upload docsPOST /kyc/applications/{id}/review— internal manual review actionPOST /webhooks/kyc-status— notify your system of status changes
Manual review payload example
{
"application_id": "kyc_12345",
"status": "manual_review",
"reason": "Document confidence below threshold",
"reviewer_notes": "Passport image blurred, request re-upload"
}
Review decision payload
{
"application_id": "kyc_12345",
"decision": "approved",
"reviewed_by": "compliance_agent_17",
"notes": "All checks passed after manual verification"
}
Best practices
- Keep an audit log of all reviewer actions
- Use role-based access control for compliance staff
- Send webhooks for status updates
- Define clear rules for when cases go to manual review
- Store evidence and reviewer notes securely
- Support SLA timers for unresolved reviews
If you want, I can also help with:
- a full KYC API design
- OpenAPI spec
- database schema
- manual review dashboard workflow
- sample code in Node/Python/Java