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

# Summary Generation APIs

> Trigger asynchronous Patient summary generation for an encounter or a provider's scheduled appointments

The Summary Generation APIs enable partners to start asynchronous Patient summary jobs after FHIR data is available in CKG. Trigger generation for a single encounter and practitioner pair, or start bulk generation for every appointment on a provider's schedule for a given date.

These APIs are called from your servers and authenticated with a Suki Token (`sdp_suki_token`). Critically, summary generation reads from data previously ingested through the CKG Data Ingestion APIs. Ensure ingestion status is `COMPLETED` and that `fhir_encounter_id` and `fhir_practitioner_id` match the identifiers in your uploaded FHIR resources.

## Available endpoints

<Columns cols={2}>
  <Card title="Generate Patient Summary For Encounter" href="/patient-summary-api-reference/summary-generation/encounter-summary" arrow={true} icon="code">
    Trigger asynchronous summary generation for one encounter and practitioner
  </Card>

  <Card title="Generate Patient Summaries For Scheduled Appointments" href="/patient-summary-api-reference/summary-generation/scheduled-appointment-summary" arrow={true} icon="code">
    Trigger bulk summary generation for all appointments on a provider's schedule
  </Card>
</Columns>

## Related guides

<Columns cols={3}>
  <Card title="Generate Patient Summaries" href="/documentation/how-to/patient-summary/generate-patient-summaries" icon="book" cta="Learn more">
    Learn scheduled and single-encounter generation workflows
  </Card>

  <Card title="Integrate CKG" href="/documentation/concepts/patient-summary/integrate-ckg" icon="book" cta="Learn more">
    Complete CKG ingestion before you trigger summary generation
  </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>
</Columns>

## Common use cases

<Columns cols={2}>
  <Card title="Pre-generate summaries before the clinic day starts">
    Call the scheduled-appointments endpoint each morning with the provider ID and date so summaries are ready when clinicians open their schedule.
  </Card>

  <Card title="Generate a summary for one upcoming visit">
    Trigger generation for a single encounter when a patient is added to the schedule or when fresh FHIR data arrives close to appointment time.
  </Card>

  <Card title="Kick off async jobs without blocking your UI">
    Start generation from your backend and return immediately while your application polls job status or loads summaries when processing completes.
  </Card>

  <Card title="Regenerate after a FHIR refresh">
    Re-trigger generation when you upload updated clinical data so the summary reflects the latest medications, problems, and visit history in CKG.
  </Card>
</Columns>