GET
/api/v1/claims
Flexysure only
List claims
Newest first, cursor paginated.
- Scope
read- Authentication
- Bearer token
- Rate limit
- 60 requests per minute per token (per-client override)
- Idempotency
- Safe to repeat (read only).
- Agent headers
- Accepts
X-Agent-CodeandX-Agent-Key: the call runs as that agent and sees only the agent's own records.
Headers
| Header | Meaning |
|---|---|
| Authorization | Bearer <access_token> (scope read) |
| X-Agent-Code | Optional. Agent code of the selling agent; the call runs with that agent's visibility. |
| X-Agent-Key | Optional, with X-Agent-Code. The agent's API key; a mismatch returns 403 agent_denied. |
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| status | query | string | No |
One of: registered, documents_pending, submitted_to_insurer, under_assessment, approved, repudiated, settled, closed, withdrawn |
| type | query | string | No |
One of: Legal, Non Legal |
| claim_type | query | string | No |
One of: accidental_damage, theft, third_party, medical, travel, death, disability, other |
| policy | query | string | No | Policy uuid. |
| from | query | string | No | Reported on or after (Y-m-d). |
| to | query | string | No | Reported on or before (Y-m-d). |
| overdue | query | boolean | No | Only claims past their status SLA. |
| open | query | boolean | No | true = still being worked; false = settled, closed or withdrawn. |
| limit | query | integer | No | Default 25, max 100. |
| cursor | query | string | No |
Example
curl -X GET 'https://flexysure.intrepidprojects.co.ke/api/v1/claims' \
-H "Authorization: Bearer $ACCESS_TOKEN" \
-H 'Accept: application/json' \
-H 'X-Agent-Code: KK01' \
-H "X-Agent-Key: $AGENT_KEY"{
"data": [
{
"uuid": "5c2e8a1b-7f3d-4e6a-9b0c-1d2e3f4a5b6c",
"claim_no": "CLM/2026/00012",
"status": "under_assessment",
"status_label": "Under assessment",
"next_statuses": [
"approved",
"repudiated",
"documents_pending",
"withdrawn"
],
"claim_type": "accidental_damage",
"claim_type_label": "Accidental damage",
"legal": false,
"legal_label": "Non Legal",
"policy": {
"uuid": "1a2b…",
"policy_no": "SG/MP/2026/000123",
"product_line": "motor"
},
"client": {
"client_no": "C-00042",
"name": "Wanjiru Kamau"
},
"insurer": {
"id": 1,
"name": "Savanna General"
},
"risk_item": "KDA 123A",
"incident_on": "2026-10-10",
"reported_on": "2026-10-11",
"description": "Rear bumper damaged at the Nyayo roundabout.",
"claimant": {
"name": null,
"phone": null,
"relationship": null
},
"insurer_ref": "SG-CL-88812",
"currency": "KES",
"amounts": {
"estimate": 150000,
"estimate_minor": 15000000,
"reserve": 140000,
"reserve_minor": 14000000,
"approved": 0,
"approved_minor": 0,
"paid": 0,
"paid_minor": 0,
"excess": 15000,
"excess_minor": 1500000,
"outstanding": 0,
"outstanding_minor": 0
},
"sla": {
"due_at": "2026-11-01T09:00:00+03:00",
"overdue": false,
"label": "18 days left",
"days_in_status": 3
},
"assigned_to": {
"id": 2,
"name": "Faith Njeri",
"role": "account_exec",
"code": null
},
"settled_on": null,
"closed_on": null,
"created_at": "2026-10-11T09:00:00+03:00"
}
],
"meta": {
"limit": 25,
"has_more": false,
"count": 1
},
"links": {
"next": null
}
}Responses
| Status | Meaning |
|---|---|
| 200 | Claims |
Errors are problem documents; the common codes (401, 403 insufficient_scope, 422, 429) apply to every endpoint.