---
title: "Get Patient Profiles"
method: GET
path: "/api/v2/ml-scribe/open-api/patient-profiles"
tags: ["Heidi API"]
---

# Get Patient Profiles

`GET /api/v2/ml-scribe/open-api/patient-profiles`

list patient profiles

## Query parameters

- `ehr_provider` 'Epic Systems' | 'Other' | 'Heidi'
- `ehr_patient_id` string, nullable
- `page` integer, nullable
- `page_size` integer, nullable

## Response `200`

Successful Response

- OpenAPIGetPatientProfilesResponse
  - `data` PatientProfileWithSessionCount[], required — unresolved $ref
  - `total_pages` integer, nullable

## Other responses

- `400` — Bad Request
- `422` — Validation Error

---

[API](https://skmtc.net/heidihealth/apis/heidi-api-documentation.md) · [All operations](https://skmtc.net/heidihealth/apis/heidi-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/heidihealth/heidi-api-documentation/revisions/39b46a9d8637/schema)