> ## Documentation Index
> Fetch the complete documentation index at: https://developer.suki.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Get Patient Summary Using Patient Summary ID
> Retrieve full details of a previously generated Patient Summary using its unique Patient Summary ID
Use this endpoint to retrieve full details of Patient Summary using its **Patient Summary ID**. Use the `patient_summary_id` returned by the [Generate Patient Summary for an Encounter](/patient-summary-api-reference/summary-generation/encounter-summary) endpoint to retrieve the summary and display it to providers.
**Important:**
* Generate the Patient Summary using the [Generate Patient Summary for an Encounter](/patient-summary-api-reference/summary-generation/encounter-summary) endpoint.
* Wait until the generation status is `COMPLETED` before retrieving the summary.
The response object includes the following sections:
* **About Visit** - Information about the visit, including the date, reason for visit, and provider information.
* **Patient Summary** - A summary of the patient's medical history, including their medications, allergies, and chronic conditions.
* **Previous Visit** - A summary of the patient's previous visit, including the date, reason for visit, and provider information.
* **Problems** - A list of the patient's problems, including their medications, allergies, and chronic conditions.
Each section above includes a list of snippets that provide detailed clinical information about the patient.
## OpenAPI
````yaml GET /api/v1/patient-summary/{patient_summary_id}
openapi: 3.0.1
info:
title: Suki Developer Platform
description: >-
REST and WebSocket APIs for the Suki Developer Platform. Authenticate with
Login or Register to obtain a Suki access token, then integrate ambient
clinical documentation, form filling, transcription, and reference metadata
endpoints.
contact: {}
version: '1.0'
servers:
- url: https://sdp.suki.ai
description: >-
Production base URL for Suki Developer Platform REST APIs. WebSocket
endpoints use the same host with `wss://`.
security:
- SukiTokenAuth: []
paths:
/api/v1/patient-summary/{patient_summary_id}:
get:
tags:
- /api/v1/patient-summary
summary: Get patient summary by ID
description: >-
Retrieve a previously generated patient summary using its unique ID. Use
this endpoint when you have the summary ID from a status response or
previous retrieval. If you need to fetch a summary for a specific
encounter and practitioner without knowing the summary ID, use GET
/api/v1/patient-summary/encounter/{fhir_encounter_id}/practitioner/{fhir_practitioner_id}
instead.
parameters:
- name: patient_summary_id
in: path
description: Patient summary identifier.
required: true
schema:
type: string
- $ref: '#/components/parameters/ProviderIdHeader'
responses:
'200':
description: Success Response
content:
application/json:
schema:
$ref: '#/components/schemas/controllers.PatientSummaryByIdResponse'
examples:
success:
value:
patient_summary:
sections:
- contents:
- problem:
description: Asthma
text: Patient presents with shortness of breath.
visit:
date: '2026-05-22T10:00:00Z'
description: Follow-up for asthma
section_type: ABOUT_VISIT
snippet_index: 0
title: About Visit
updated_at: '2026-05-22T10:00:00Z'
'400':
description: Bad request. The request parameters failed validation.
content:
application/json:
schema:
$ref: '#/components/schemas/controllers.BadRequestError'
'401':
description: Unauthorized. The Suki access token is missing, expired, or invalid.
content:
application/json:
schema:
$ref: '#/components/schemas/controllers.AuthenticationError'
'404':
description: Not found. The patient summary does not exist.
content:
application/json:
schema:
$ref: '#/components/schemas/controllers.NotFoundError'
'500':
description: Internal server error.
content:
application/json:
schema:
$ref: '#/components/schemas/controllers.InternalServerError'
security:
- SukiTokenAuth: []
x-codeSamples:
- lang: bash
label: cURL
source: |-
curl --request GET \
--url https://sdp.suki.ai/api/v1/patient-summary/ \
--header 'sdp_suki_token: ' \
--header 'sdp_provider_id: '
components:
parameters:
ProviderIdHeader:
name: sdp_provider_id
in: header
description: >-
**Optional** for standard partners.
**Required** for:
- **Bearer authentication.** Use the same `provider_id` returned by the
Login or Register API.
- **Single Auth Token authentication.** Include the same `provider_id`
on every request as `sdp_provider_id`.
required: false
schema:
type: string
example: provider-123
schemas:
controllers.PatientSummaryByIdResponse:
type: object
description: Success Response
properties:
patient_summary:
$ref: '#/components/schemas/controllers.PatientSummaryDocument'
controllers.BadRequestError:
description: Bad Request Response
type: object
properties:
code:
type: integer
example: 400
message:
type: string
example: invalid request
controllers.AuthenticationError:
description: Authentication Failure Response
type: object
properties:
code:
type: integer
example: 401
message:
type: string
example: invalid token
controllers.NotFoundError:
description: Not Found Response
type: object
properties:
code:
type: integer
example: 404
message:
type: string
example: not found
controllers.InternalServerError:
description: Internal Server Error Response
type: object
properties:
code:
type: integer
example: 500
message:
type: string
example: internal server error
controllers.PatientSummaryDocument:
type: object
description: >-
Comprehensive patient summary document with all relevant clinical
information organized into sections.
properties:
sections:
type: array
description: Clinical information organized into logical sections.
items:
$ref: '#/components/schemas/controllers.PatientSummarySectionV2'
updated_at:
type: string
format: date-time
description: RFC 3339 timestamp when the patient summary was last updated.
example: '2026-05-22T10:00:00Z'
controllers.PatientSummarySectionV2:
type: object
description: >-
Individual section within a patient summary containing related clinical
information.
properties:
contents:
type: array
description: >-
Content items within this section, each representing a clinical
snippet with optional problem and visit context.
items:
$ref: '#/components/schemas/controllers.PatientSummaryContentItem'
section_type:
type: string
description: Type identifier for this section (e.g., ABOUT_VISIT).
example: ABOUT_VISIT
snippet_index:
type: integer
description: Index of this snippet within the section.
example: 0
title:
type: string
description: Human-readable title for this section.
example: About Visit
controllers.PatientSummaryContentItem:
type: object
description: A single content item within a patient summary section.
properties:
problem:
$ref: '#/components/schemas/controllers.PatientSummaryProblem'
text:
type: string
description: Clinical text describing the content.
example: Patient presents with shortness of breath.
visit:
$ref: '#/components/schemas/controllers.PatientSummaryVisit'
controllers.PatientSummaryProblem:
type: object
description: Problem or diagnosis associated with the content item.
properties:
description:
type: string
description: Description of the problem.
example: Asthma
controllers.PatientSummaryVisit:
type: object
description: Visit details associated with the content item.
properties:
date:
type: string
format: date-time
description: RFC 3339 timestamp of the visit.
example: '2026-05-22T10:00:00Z'
description:
type: string
description: Description of the visit.
example: Follow-up for asthma
securitySchemes:
SukiTokenAuth:
type: apiKey
in: header
name: sdp_suki_token
description: >-
Suki access token (`suki_token`) from Login or Register. Expires after
one hour.
````