Patient Summary Generation
Generate Patient Summary For Specific Encounter
Trigger asynchronous generation of summaries for a specific encounter and practitioner from CKG data
POST
cURL
Use this endpoint to generate summaries by providing the
Prerequisites:
fhir_encounter_id and fhir_practitioner_id. The endpoint retruns patient_summary_id.
Use patient_summary_id to retrieve the generated summaries via the Get full Patient Summary using Patient Summary ID endpoint.
Patient summaries are generated from data previously ingested into the Clinical Knowledge Graph (CKG).
Before calling this endpoint, ensure the required Patient, Encounter, and Practitioner resources have been ingested using the CKG Data Ingestion APIs.
- Ingest the required Patient, Encounter, and Practitioner resources using the CKG Data Ingestion APIs.
- Include consistent patient, encounter, and practitioner identifiers in the FHIR resources.
- Ensure these identifiers match the
fhir_encounter_idandfhir_practitioner_idvalues you use for generation and retrieval.
Generation typically completes within a few seconds to a few minutes, depending on the amount of patient data available in the CKG.
Request body
After the request returns 201, call the Patient Summary retrieval endpoint with
patient_summary_id (or use the encounter/practitioner retrieval path) to fetch the generated summary by using the following endpoints:
Authorizations
Suki access token (suki_token) from Login or Register. Expires after one hour.
Headers
Optional for standard partners.
Required for:
- Bearer authentication. Use the same
provider_idreturned by the Login or Register API. - Single Auth Token authentication. Include the same
provider_idon every request assdp_provider_id.
Example:
"provider-123"
Body
application/json
Response
Created. Summary generation request accepted and a patient summary resource was created.
Patient summary job ID returned from generate APIs.
Last modified on August 7, 2026
cURL