---
title: "Generate patient summary for an encounter"
method: POST
path: "/api/v1/patient-summary/generate/encounter"
tags: ["/api/v1/patient-summary"]
---

# Generate patient summary for an encounter

`POST /api/v1/patient-summary/generate/encounter`

## Request

- Base URL: `https://sdp.suki.ai`
- URL: `https://sdp.suki.ai/api/v1/patient-summary/generate/encounter`
- Auth: API key in header `sdp_suki_token`

Trigger asynchronous generation of a patient summary for a specific encounter and practitioner. The API returns 202 Accepted immediately when the job is scheduled. Generation typically completes within seconds to minutes depending on the volume of CKG data available. Poll GET /api/v1/patient-summary/encounter/{fhir_encounter_id}/practitioner/{fhir_practitioner_id}/status to check when generation completes, then retrieve the summary via the GET endpoint. Ensure FHIR data for the patient, encounter, and practitioner has been ingested via the CKG Data Ingestion API before triggering generation.

## Headers

- `sdp_provider_id` string

## Request body

- object
  - `fhir_encounter_id` string, required: FHIR encounter identifier (required).
  - `fhir_practitioner_id` string, required: FHIR practitioner identifier (required).

## Response `201`

Created. Summary generation request accepted and a patient summary resource was created.

- object
  - `patient_summary_id` string, required: Patient summary job ID returned from generate APIs.

## Other responses

- `400`: Bad request. The request body or parameters failed validation.
- `401`: Unauthorized. The Suki access token is missing, expired, or invalid.
- `403`: Forbidden. Token lacks required scopes or access to the organization.
- `500`: Internal server error.

## Changes

- **2026-11-03** `2181be71d4dd`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/suki/apis/suki-developer-platform/changes/api/v1/patient-summary/generate/encounter/post.md)

---

[API](https://skmtc.dev/suki/apis/suki-developer-platform.md) - [All operations](https://skmtc.dev/suki/apis/suki-developer-platform/llms.txt) - [OpenAPI document](https://skmtc.dev/suki/apis/suki-developer-platform/revisions/2181be71d4dd?raw)