> ## Documentation Index
> Fetch the complete documentation index at: https://docs.verify-group.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Claims management

> Create insurance claims, transition statuses, attach participants, and inspect the audit trail across the full Verify Group claims lifecycle.

## Create a claim

```bash theme={null}
POST /api/v1/claims
```

```json theme={null}
{
  "type": "MOTOR",
  "policyNumber": "POL-MT-KE-2025-8847",
  "description": "Rear-end collision on Mombasa Road",
  "incidentDate": "2026-06-15",
  "claimAmount": 185000
}
```

## Update status

```bash theme={null}
PATCH /api/v1/claims/{id}/status
```

```json theme={null}
{"status": "INVESTIGATING", "reason": "Elevated fraud score"}
```

## Add participants

```bash theme={null}
POST /api/v1/claims/{claimId}/pois
```

```json theme={null}
{"personId": "participant-uuid", "role": "claimant"}
```

<Note>Assigning an investigator automatically transitions the claim to `INVESTIGATING`.</Note>

## Audit trail

```bash theme={null}
GET /api/v1/audit/logs?resourceType=claim&resourceId={claimId}&sortBy=createdAt&sortOrder=desc
```