> ## 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 Patient Summary ID

> Returns the generation status for a Patient Summary using its unique ID

Use this endpoint to check the **generation status** when you have the `patient_summary_id` from a previous generation request using the [Generate Patient Summary for an Encounter](/patient-summary-api-reference/summary-generation/encounter-summary) endpoint.

<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 using the following endpoints:

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


## OpenAPI

````yaml GET /api/v1/patient-summary/{patient_summary_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/{patient_summary_id}/status:
    get:
      tags:
        - /api/v1/patient-summary
      summary: Get summary generation status by ID
      description: >-
        Returns the orchestration job status for the given patient summary ID.
        Common status values include READY, RUNNING, COMPLETED, FAILED, and
        ABORTED.
      parameters:
        - name: patient_summary_id
          in: path
          description: Patient summary 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 patient summary 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/<patient_summary_id>/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.

````