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

# List Patients

`GET /api/v2/patients`

## Query parameters

- `continuation_token` string

## 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

---

[API](https://skmtc.net/particlehealth/apis/particle-health-api.md) · [All operations](https://skmtc.net/particlehealth/apis/particle-health-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/particlehealth/particle-health-api/revisions/5aead0b7515e/schema)