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

# Get Summary Generation Status Using Encounter & Practitioner IDs

> Returns the generation status for a summary generation job using the encounter and practitioner IDs you provided

Use this endpoint to check the **status** of a **summary generation** job using the **encounter** and **practitioner** IDs you provided when triggering summary generation. Choose this approach when you do not have `patient_summary_id` to check generation status.

<Note>
  **Important:**

  * Ingest the required FHIR data using the [CKG Data Ingestion APIs](/patient-summary-api-reference/ckg-data-ingestion).
  * Trigger summary generation using [Generate Patient Summary for an Encounter](/patient-summary-api-reference/summary-generation/encounter-summary).
  * Call this endpoint only after the summary generation request has been submitted.
</Note>

## Generation status values

Generation status values include `READY`, `RUNNING`, `COMPLETED`, `FAILED`, and `ABORTED`.

## Polling guidelines

* Poll at reasonable intervals (e.g., every **5 seconds**).
* Stop polling once you receive a terminal status (`COMPLETED`, `FAILED`, or `ABORTED`).
* Generation typically completes within seconds to minutes depending on patient data volume.

Once status is `COMPLETED`, retrieve the full Patient Summary by using the following endpoints:

<div className="doc-guide-btn-row">
  <a href="/patient-summary-api-reference/summaries/encounter-practitioner" className="doc-guide-btn">
    Get Patient Summary
  </a>

  <a href="/patient-summary-api-reference/summaries/encounter-pre-visit" className="doc-guide-btn">
    Get Pre-Visit Summary
  </a>
</div>


## OpenAPI

````yaml GET /api/v1/patient-summary/encounter/{fhir_encounter_id}/practitioner/{fhir_practitioner_id}/status
openapi: 3.0.1
info:
  title: Suki Developer Platform
  description: >-
    REST and WebSocket APIs for the Suki Developer Platform. Authenticate with
    Login or Register to obtain a Suki access token, then integrate ambient
    clinical documentation, form filling, transcription, and reference metadata
    endpoints.
  contact: {}
  version: '1.0'
servers:
  - url: https://sdp.suki.ai
    description: >-
      Production base URL for Suki Developer Platform REST APIs. WebSocket
      endpoints use the same host with `wss://`.
security:
  - SukiTokenAuth: []
paths:
  /api/v1/patient-summary/encounter/{fhir_encounter_id}/practitioner/{fhir_practitioner_id}/status:
    get:
      tags:
        - /api/v1/patient-summary
      summary: Get patient summary generation status for encounter
      description: >-
        Returns the orchestration job status for the given FHIR encounter and
        practitioner identifiers (same format as sent via CKG ingestion). Common
        status values include READY, RUNNING, COMPLETED, FAILED, and ABORTED.
      parameters:
        - name: fhir_encounter_id
          in: path
          description: FHIR encounter identifier.
          required: true
          schema:
            type: string
        - name: fhir_practitioner_id
          in: path
          description: FHIR practitioner identifier.
          required: true
          schema:
            type: string
        - $ref: '#/components/parameters/ProviderIdHeader'
      responses:
        '200':
          description: Success Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                    description: Orchestration job status.
                    enum:
                      - READY
                      - RUNNING
                      - COMPLETED
                      - FAILED
                      - ABORTED
                    example: RUNNING
        '400':
          description: Bad request. The request parameters failed validation.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/controllers.BadRequestError'
        '401':
          description: Unauthorized. The Suki access token is missing, expired, or invalid.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/controllers.AuthenticationError'
        '404':
          description: Not found. The encounter or practitioner does not exist.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/controllers.NotFoundError'
        '500':
          description: Internal server error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/controllers.InternalServerError'
      security:
        - SukiTokenAuth: []
      x-codeSamples:
        - lang: bash
          label: cURL
          source: |-
            curl --request GET \
              --url https://sdp.suki.ai/api/v1/patient-summary/encounter/enc-123/practitioner/pract-456/status \
              --header 'sdp_suki_token: <sdp_suki_token>' \
              --header 'sdp_provider_id: <sdp_provider_id>'
components:
  parameters:
    ProviderIdHeader:
      name: sdp_provider_id
      in: header
      description: >-
        **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`.
      required: false
      schema:
        type: string
        example: provider-123
  schemas:
    controllers.BadRequestError:
      description: Bad Request Response
      type: object
      properties:
        code:
          type: integer
          example: 400
        message:
          type: string
          example: invalid request
    controllers.AuthenticationError:
      description: Authentication Failure Response
      type: object
      properties:
        code:
          type: integer
          example: 401
        message:
          type: string
          example: invalid token
    controllers.NotFoundError:
      description: Not Found Response
      type: object
      properties:
        code:
          type: integer
          example: 404
        message:
          type: string
          example: not found
    controllers.InternalServerError:
      description: Internal Server Error Response
      type: object
      properties:
        code:
          type: integer
          example: 500
        message:
          type: string
          example: internal server error
  securitySchemes:
    SukiTokenAuth:
      type: apiKey
      in: header
      name: sdp_suki_token
      description: >-
        Suki access token (`suki_token`) from Login or Register. Expires after
        one hour.

````