REFERENCE · REQUESTS AND VERDICTS
POST /v1/requests/{request_id}/extend
Extend the hard limit on one open verification request. Adds whole hours to sla_hard_at. Only while the request is open. No cap per call or in total: the verifying entity decides how long to wait. Each extension is an audit event.
PARAMETERS
| NAME | TYPE | REQUIRED | DESCRIPTION |
|---|---|---|---|
| request_id | string | yes | |
| hours | integer | yes | |
| reason | string | no |
RESPONSE
| FIELD | TYPE | DESCRIPTION |
|---|---|---|
| request_id | string | |
| insured_ref | string | |
| consumer_ref | string | |
| coverage_line_id | string | |
| opened_at | timestamp | |
| sla_target_at | timestamp | |
| sla_hard_at | timestamp | The effective hard stop, extensions included |
| status | enum | open, verdict_due, overdue, closed. |
| closed_at | timestamp | |
| close_reason | string | verified | refused | contradicted | timed_out | unable_to_verify | historical | surface_not_passed | superseded | engagement_ended, with a _late suffix when a late answer re-resolved the line. surface_not_passed: the engagement's surface check stopped passing; a new clock opens when it passes again. engagement_ended: POST /engagements/{engagement_id}/end |
| verification_attempts | object[] | Outreach so far, one entry per contact thread, oldest first |
| extensions | object[] | Every extension applied to this request, oldest first |
| total_extension_hours | integer | |
| final_verdict_id | string | The current line verdict once the line resolved |
| engagement_ids | string[] | Every engagement this clock serves (0015). One clock per coverage line and consumer; more than one entry when several requirement sets with the consumer cleared the same line on paper |
| test | boolean | true when the request was opened on test-mode data |
Errors: 400, 401, 403, 404, 409, 422, 429, 500. Every error body carries error.code, error.message, and error.request_id.