---
title: "Get Eligibility Timeline"
method: GET
path: "/patients/v1/{id}/eligibility-timeline"
tags: ["v1"]
---

# Get Eligibility Timeline

`GET /patients/v1/{id}/eligibility-timeline`

## Request

- Base URL: `https://pre-api.joincandidhealth.com`
- URL: `https://pre-api.joincandidhealth.com/patients/v1/{id}/eligibility-timeline`
- Auth: HTTP bearer

Gets a patient's eligibility audit timeline, newest-first.  Org-scoped and keyset-paginated.

## Path parameters

- `id` string, required: The unique identifier for a Patient

## Query parameters

- `event_types` 'APPOINTMENT_STATUS_CHANGED' | 'APPOINTMENT_WORK_QUEUE_CHANGED' | 'APPOINTMENT_COPAY_UPDATED' | 'COVERAGE_CREATED' | 'COVERAGE_UPDATED' | 'ELIG_CHECK_COMPLETED' | 'PATIENT_TAGS_UPDATED' | 'PATIENT_SELF_PAY_UPDATED'
- `coverage_id` string, uuid: The unique identifier for a Coverage in the database
- `appointment_id` string: The unique identifier for an Appointment.
- `page_token` string: A token that can be used to retrieve the next or previous page of results
- `limit` integer

## Response `200`

Response with status 200

- PreEncounterPatientsV1EligibilityTimelinePage
  - `next_page_token` string: A token that can be used to retrieve the next or previous page of results
  - `prev_page_token` string: A token that can be used to retrieve the next or previous page of results
  - `total` integer, required
  - `items` PreEncounterPatientsV1EligibilityTimelineEvent[], required
    - `id` string, required
    - `event_type` 'APPOINTMENT_STATUS_CHANGED' | 'APPOINTMENT_WORK_QUEUE_CHANGED' | 'APPOINTMENT_COPAY_UPDATED' | 'COVERAGE_CREATED' | 'COVERAGE_UPDATED' | 'ELIG_CHECK_COMPLETED' | 'PATIENT_TAGS_UPDATED' | 'PATIENT_SELF_PAY_UPDATED', required
    - `patient_id` string, required: The unique identifier for a Patient
    - `coverage_id` string, uuid: The unique identifier for a Coverage in the database
    - `appointment_id` string: The unique identifier for an Appointment.
    - `appointment_date` string, date-time
    - `timestamp` string, date-time, required
    - `user_id` string, required
    - `user_name` string, required: Actor display name; "Candid Health" for automated writes.
    - `payload` object, required: Event-type-specific payload.

## Changes

- **2026-10-29** `d8b0a61873e2`: 1 warning, 1 info
  - added the new `PATIENT_SELF_PAY_UPDATED` enum value to the `items/items/event_type` response property for the response status `200`
  - added the new enum value `PATIENT_SELF_PAY_UPDATED` to the `query` request parameter `event_types`
- **2026-09-17** `24b2d80d577a`: 2 breaking, 1 warning, 17 info
  - the `query` request parameter `event_types` was restricted to a list of enum values
  - the response's body type changed from no type to `object` for status `200`
  - deleted the `header` request parameter `Authorization`
  - the endpoint scheme security `OAuthScheme` was added to the API
  - …16 more
- **2026-09-12** `3a81ee81d4ed`: 1 info
  - api operation id `get_eligibility_timeline` removed and replaced with `v1_get_eligibility_timeline`
- **2026-07-26** `bb0d15478d65`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/joincandidhealth/apis/api-reference/changes/patients/v1/:id/eligibility-timeline/get.md)

---

[API](https://skmtc.dev/joincandidhealth/apis/api-reference.md) - [All operations](https://skmtc.dev/joincandidhealth/apis/api-reference/llms.txt) - [OpenAPI document](https://skmtc.dev/joincandidhealth/apis/api-reference/revisions/d8b0a61873e2?raw)