> ## 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.

# CKG Data Ingestion APIs

> Upload FHIR bundles into Suki's Clinical Knowledge Graph (CKG) and poll ingestion status

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

<Columns cols={3}>
  <Card title="Request FHIR Bundle Upload URL" href="/patient-summary-api-reference/ckg-data-ingestion/upload" arrow={true} icon="code">
    Request a pre-signed upload URL for a FHIR bundle ingestion job
  </Card>

  <Card title="Upload FHIR Bundle" href="/patient-summary-api-reference/ckg-data-ingestion/fhir-data" arrow={true} icon="code">
    Upload FHIR bundle JSON to the pre-signed URL returned in Step 1
  </Card>

  <Card title="Check Ingestion Status" href="/patient-summary-api-reference/ckg-data-ingestion/ingestion-status" arrow={true} icon="code">
    Poll ingestion status for a FHIR push transaction until CKG processing completes
  </Card>
</Columns>

## Related guides

<Columns cols={3}>
  <Card title="Integrate CKG" href="/documentation/concepts/patient-summary/integrate-ckg" icon="book" cta="Learn more">
    Learn why CKG is required and how to upload and monitor FHIR ingestion
  </Card>

  <Card title="Patient Summary Basic Usage" href="/documentation/how-to/patient-summary/basic-usage" icon="book" cta="Learn more">
    Learn the upload, generate, poll, and retrieve Patient Summary flow
  </Card>

  <Card title="Patient Summary Overview" href="/documentation/concepts/patient-summary/overview" icon="book" cta="Learn more">
    Learn when Patient Summary fits your clinical workflow
  </Card>
</Columns>

## Common use cases

<Columns cols={2}>
  <Card title="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.
  </Card>

  <Card title="Refresh chart data on a schedule">
    Push updated FHIR bundles when medications, problems, or visit history change so summaries reflect current clinical information.
  </Card>

  <Card title="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.
  </Card>

  <Card title="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.
  </Card>
</Columns>