---
title: "Get Patient Timeline"
method: GET
path: "/v1/patients/{patient_id}/timeline"
tags: ["Patients"]
---

# Get Patient Timeline

`GET /v1/patients/{patient_id}/timeline`

## Path parameters

- `patient_id` string, uuid, required

## Query parameters

- `types[]` TimelineItemType[], nullable
- `page` integer
- `limit` integer

## Response `200`

Successful Response

- TimelineList
  - `data` union[], required
    - union
      - EventTimelineItem
        - `id` string, required
        - `sort_date` string, nullable, required
        - `type` 'event', required
        - `data` EventData, required
          - `id` string, required
          - `type` string, required
          - `description` string, nullable
          - `metadata` object, nullable
          - `patient_id` string, required
          - `created_at` string, nullable
          - `created_by` string, nullable
      - CallTimelineItem
        - `id` string, required
        - `sort_date` string, nullable, required
        - `type` 'call', required
        - `data` CallData, required
          - `id` string, required
          - `type` string, required
          - `assistant_id` string, required
          - `phone_number_id` string, nullable
          - `org_id` string, nullable
          - `patient_id` string, nullable
          - `customer_number` string, nullable
          - `started_at` string, nullable
          - `ended_at` string, nullable
          - `duration_min` number, nullable
          - `transcript` string, nullable
          - `summary` string, nullable
          - `status` string, nullable
          - `category` string, nullable
          - `cost` number, nullable
          - `ended_reason` string, nullable
          - `score` integer, nullable
          - `language` string, nullable
          - `structured_data` object, nullable
          - `messages` unknown[], nullable
            - unknown
          - `answered` boolean, nullable
          - `created_at` string, nullable
          - `assistant` object, nullable
      - MessageTimelineItem
        - `id` string, required
        - `sort_date` string, nullable, required
        - `type` 'message', required
        - `data` MessageData, required
          - `id` string, required
          - `conversation_id` string, required
          - `sender_id` string, nullable
          - `sender_type` string, required
          - `content` string, required
          - `status` string, nullable
          - `is_read` boolean, nullable
          - `phone_number_id` string, nullable
          - `created_at` string, nullable
          - `updated_at` string, nullable
          - `sender_name` string, nullable
          - `files` unknown[], nullable
            - unknown
      - FaxTimelineItem
        - `id` string, required
        - `sort_date` string, nullable, required
        - `type` 'fax', required
        - `data` FaxData, required
          - `id` string, required
          - `patient_id` string, nullable
          - `from_fax_number` string, nullable
          - `extracted_data` object, nullable
          - `processing_status` string, nullable
          - `status` string, nullable
          - `type` string, nullable
          - `page_count` integer, nullable
          - `created_at` string, nullable
      - TaskTimelineItem
        - `id` string, required
        - `sort_date` string, nullable, required
        - `type` 'task', required
        - `data` TaskData, required
          - `id` string, required
          - `title` string, required
          - `description` string, nullable
          - `tags` string[], nullable
          - `deadline` string, nullable
          - `priority` string, nullable
          - `status` string, nullable
          - `type` string, nullable
          - `patient_id` string, nullable
          - `created_by_id` string, nullable
          - `active` boolean, nullable
          - `created_at` string, nullable
          - `created_by` object, nullable
          - `assigned_users` unknown[], nullable
            - unknown
      - FormSubmissionTimelineItem
        - `id` string, required
        - `sort_date` string, nullable, required
        - `type` 'form_submission', required
        - `data` FormSubmissionData, required
          - `id` string, required
          - `form_id` string, required
          - `patient_id` string, nullable
          - `data` object, nullable
          - `status` string, nullable
          - `responded_at` string, nullable
          - `created_at` string, nullable
          - `form` object, nullable
      - PriorAuthTimelineItem
        - `id` string, required
        - `sort_date` string, nullable, required
        - `type` 'prior_auth', required
        - `data` PriorAuthData, required — A prior-authorization lifecycle event, derived from the PA's own timestamps (created/submitted/decided) — there is no separate PA-event table. `prior_authorization_id` links the row to the PA; `event` is the lifecycle stage; `created_at` is when that stage occurred.
          - `id` string, required
          - `prior_authorization_id` string, required
          - `patient_id` string, nullable
          - `event` string, required
          - `pa_type` string, nullable
          - `status` string, nullable
          - `decision` string, nullable
          - `created_at` string, nullable
  - `pagination` Pagination, required — Pagination information for list responses. Fields: - has_more: Whether more items exist beyond this page - total: Total number of items across all pages - page: Current page number (1-based) - limit: Number of items per page
    - `has_more` boolean, required
    - `total` integer, required
    - `page` integer, required
    - `limit` integer, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/getsolum/apis/solum-health-api.md) · [All operations](https://skmtc.net/getsolum/apis/solum-health-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/getsolum/solum-health-api/revisions/2bf886cdf729/schema)