---
title: "List Cases"
method: GET
path: "/mr/api/v1/cases"
tags: ["Cases"]
---

# List Cases

`GET /mr/api/v1/cases`

This endpoint returns a list of all cases. Results are always ordered by ascending value of `updated_at`.

**Note**: Use the `offset` param (i.e. `next_token`) for pagination and `u_at__gt` for incremental sync.

## Query parameters

- `offset` string
- `u_at__gt` integer

## Headers

- `X-Pt-Id` string, required

## Response `200`

List of cases

- object
  - `cases` object[]
    - `id` string
    - `status` string — Possible enums — A (Active), D (Deleted)
    - `updated_at` integer
    - `item` object, nullable — Will be missing in case of deleted case
      - `display_name` string
      - `type` string
      - `hi_type` 'OPConsultation' | 'Prescription' | 'DischargeSummary' | 'DiagnosticReport' | 'ImmunizationRecord' | 'HealthDocumentRecord' | 'WellnessRecord' — Type of case
      - `partner_meta` object — metadata attached to the case.
      - `created_at` integer
      - `occurred_at` integer
  - `next_token` string, nullable — Token for fetching the next page, if available

## Other responses

- `401` — Unauthorized - Invalid token
- `500` — Internal server error

---

[API](https://skmtc.net/eka/apis/eka-developer-apis.md) · [All operations](https://skmtc.net/eka/apis/eka-developer-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/eka/eka-developer-apis/revisions/9ea23456f722/schema)