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

# Patient Summaries APIs

> Retrieve full Patient Summaries and pre-visit sections after generation completes

The Patient Summaries Retrieval APIs enable partners to retrieve generated Patient Summary content after a summary job completes. Fetch the full summary object for chart review, or retrieve the pre-visit section from inside the full patient summary using a dedicated endpoint to display a preview in the provider's schedule interface.

These APIs are called from your servers and authenticated with a Suki Token (`sdp_suki_token`). Critically, wait until summary generation status is `COMPLETED` before you treat summary content as final. Use `patient_summary_id` when you stored it from a generation response, or pass your `fhir_encounter_id` and `fhir_practitioner_id` when you resolve summaries by partner identifiers.

## Available endpoints

<Columns cols={2}>
  <Card title="Patient Summary (ID)" href="/patient-summary-api-reference/summaries/patient-summary" arrow={true} icon="code">
    Retrieve the full Patient Summary using `patient_summary_id`
  </Card>

  <Card title="Pre-Visit Summary (ID)" href="/patient-summary-api-reference/summaries/pre-visit-summary" arrow={true} icon="code">
    Retrieve the pre-visit section using `patient_summary_id`
  </Card>

  <Card title="Patient Summary (Partner IDs)" href="/patient-summary-api-reference/summaries/encounter-practitioner" arrow={true} icon="code">
    Retrieve the full Patient Summary using encounter and practitioner identifiers
  </Card>

  <Card title="Pre-Visit Summary (Partner IDs)" href="/patient-summary-api-reference/summaries/encounter-pre-visit" arrow={true} icon="code">
    Retrieve the pre-visit section using encounter and practitioner identifiers
  </Card>
</Columns>

## Related guides

<Columns cols={3}>
  <Card title="Retrieve Patient Summaries" href="/documentation/how-to/patient-summary/retrieve-patient-summaries" icon="book" cta="Learn more">
    Learn when to retrieve full and pre-visit summaries
  </Card>

  <Card title="Generate Patient Summaries" href="/documentation/how-to/patient-summary/generate-patient-summaries" icon="book" cta="Learn more">
    Learn how generation jobs complete before you retrieve content
  </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="Show a full summary during chart review">
    Retrieve the comprehensive Patient Summary object and present About Visit, Patient Summary, Previous Visit, and Problems sections before or during the encounter.
  </Card>

  <Card title="Display pre-visit previews in schedule views">
    Load the pre-visit section for each appointment to display a preview to the provider directly in the schedule or appointment list interface.
  </Card>

  <Card title="Look up summaries with your own encounter IDs">
    Use encounter and practitioner identifiers from your EHR when you do not persist `patient_summary_id` in your scheduling or charting workflow.
  </Card>

  <Card title="Integrate summary sections into your EHR UI">
    Map structured summary sections and snippets into your review screens, dashboards, or handoff workflows after generation completes.
  </Card>
</Columns>