---
title: "List a patient's scribe sessions"
method: GET
path: "/v1/patients/{patient_id}/scribe-sessions"
tags: ["Patients"]
---

# List a patient's scribe sessions

`GET /v1/patients/{patient_id}/scribe-sessions`

## Request

- Base URL: `https://scribe-api.telepatia.ai`
- URL: `https://scribe-api.telepatia.ai/v1/patients/{patient_id}/scribe-sessions`
- Auth: HTTP bearer

List the scribe sessions for a patient, paginated. The patient id can be the public id (sp_...) or the internalCode you set for your institution.

## Path parameters

- `patient_id` string, required

## Query parameters

- `page` integer: Page number (1-based).
- `limit` integer: Number of items per page.

## Response `200`

Successful Response

- PatientSessionListResponse: Paginated list of a patient's scribe sessions.
  - `items` PatientSessionItem[], required: Page of scribe sessions.
    - `id` string, required
    - `status` string, required
    - `createdAt` string, date-time, nullable
    - `completedAt` string, date-time, nullable
    - `patientName` string, nullable
    - `scribeSessionModality` string, nullable: The modality of the scribe session (e.g. 'IN_PERSON', 'TELEMEDICINE').
    - `consultationInternalId` string, nullable: The consultation ID provided by the API consumer.
    - `specialty` string, nullable: The medical specialty of the clinician who conducted the session.
  - `total` integer, required: Total sessions for the patient in the caller's scope.
  - `page` integer, required: Current page number (1-based).
  - `limit` integer, required: Number of items per page.
  - `totalPages` integer, required: Total number of pages.
  - `hasMore` boolean, required: Whether another page exists.

## Other responses

- `400`: Bad Request — invalid parameters, validation failures, or missing fields.
- `401`: Unauthorized — missing or invalid API key.
- `404`: Not Found — the requested resource does not exist.
- `503`: Service Unavailable — an external dependency is down.

---

[API](https://skmtc.dev/telepatia/apis/scribe-public-api.md) - [All operations](https://skmtc.dev/telepatia/apis/scribe-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/telepatia/apis/scribe-public-api/revisions/be963942e472?raw)