Skip to main content
POST
cURL
Use this endpoint to generate summaries by providing the 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.
  • It is recommended that partners send Suki this data every morning (at midnight) for all appointments scheduled that day in order to avoid waiting for the API to complete the generation process.
  • Processing speed: Each individual appointment takes roughly 20 seconds to generate a Patient Summary once the API is triggered.
Prerequisites:
  • 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_id and fhir_practitioner_id values 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

sdp_suki_token
string
header
required

Suki access token (suki_token) from Login or Register. Expires after one hour.

Headers

sdp_provider_id
string

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.
Example:

"provider-123"

Body

application/json
fhir_encounter_id
string
required

FHIR encounter identifier (required).

fhir_practitioner_id
string
required

FHIR practitioner identifier (required).

Response

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

patient_summary_id
string
required

Patient summary job ID returned from generate APIs.

Last modified on August 7, 2026