Skip to main content
The CKG Data Ingestion APIs enable partners to load FHIR clinical data into Suki’s Clinical Knowledge Graph (CKG) before Patient summaries can be generated. Request a pre-signed upload URL, upload your FHIR bundle, then poll ingestion status until processing completes. These APIs are called from your servers and authenticated with an RS256-signed SDP JWT bearer token that includes the sdp_partner_id claim and the scopes required for the endpoint. Critically, Patient Summary generation depends on identifiers in your ingested FHIR data. Include consistent patient, encounter, and practitioner identifiers in the FHIR resources you upload, and use the same values as fhir_encounter_id and fhir_practitioner_id when you trigger generation and retrieve summaries.

Available endpoints

Request FHIR Bundle Upload URL

Request a pre-signed upload URL for a FHIR bundle ingestion job

Upload FHIR Bundle

Upload FHIR bundle JSON to the pre-signed URL returned in Step 1

Check Ingestion Status

Poll ingestion status for a FHIR push transaction until CKG processing completes

Integrate CKG

Learn why CKG is required and how to upload and monitor FHIR ingestion

Patient Summary Basic Usage

Learn the upload, generate, poll, and retrieve Patient Summary flow

Patient Summary Overview

Learn when Patient Summary fits your clinical workflow

Common use cases

Load clinical data before summary generation

Upload Patient, Encounter, Practitioner, and related FHIR resources so CKG has the chart context required to generate Patient Summaries.

Refresh chart data on a schedule

Push updated FHIR bundles when medications, problems, or visit history change so summaries reflect current clinical information.

Ingest provider schedules for bulk generation

Upload schedule and appointment FHIR data so you can trigger summary generation for all of a provider’s appointments on a given date.

Track ingestion jobs until CKG processing finishes

Poll transaction status after upload so your backend knows when data is ready for summary generation or when an upload failed or expired.
Last modified on August 7, 2026