---
title: "List Patients"
method: GET
path: "/api/v2/patients"
tags: ["Patients"]
---

# List Patients

`GET /api/v2/patients`

## Request

- Base URL: `https://sandbox.particlehealth.com`
- URL: `https://sandbox.particlehealth.com/api/v2/patients`
- Auth: API key in header `Authorization`

## Query parameters

- `continuation_token` string
- `filter` 'signal_enrolled'

## Response `200`

OK

- ApiPatientList
  - `continuation_token` string
  - `patients` ApiPatientListItem[]
    - `date_of_birth` string: The patient's date of birth, this field is required and must be of the format YYYY-MM-DD.
    - `expected_completion_time` string: ExpectedCompletionTime is the number of files found for a paritcular patient.
    - `external_patient_id` string: External Patient ID assigned by the customer
    - `family_name` string: The patient's family name (last name), this field is required.
    - `file_count` string: FileCount is the number of files found for a paritcular patient.
    - `gender` string: The patient's gender, must be either FEMALE or MALE.
    - `given_name` string: The patient's given name (first name), this field is required.
    - `particle_patient_id` string: ParticlePatientID is the unique identifier for the patient in the Particle Health system.
    - `query_date` string: Query Date
    - `query_id` string: Query ID
    - `query_status` string: Query Status
    - `request_endpoint` string: RequestEndpoint is the endpoint used to initiate the query.

## Other responses

- `204`: No Content
- `400`: Bad Request
- `401`: Unauthorized
- `404`: Not Found
- `406`: Not Acceptable
- `500`: Internal Server Error

## Changes

- **2026-11-03** `b59a5413a488`: 7 info
  - added the new optional `query` request parameter `filter`
  - added the optional property `error_code` to the response with the `204` status
  - added the optional property `error_code` to the response with the `400` status
  - added the optional property `error_code` to the response with the `401` status
  - …3 more

[Operation history](https://skmtc.dev/particlehealth/apis/particle-health-api/changes/api/v2/patients/get.md)

---

[API](https://skmtc.dev/particlehealth/apis/particle-health-api.md) - [All operations](https://skmtc.dev/particlehealth/apis/particle-health-api/llms.txt) - [OpenAPI document](https://skmtc.dev/particlehealth/apis/particle-health-api/revisions/b59a5413a488?raw)