> ## Documentation Index
> Fetch the complete documentation index at: https://www.everbility.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Launch Session Status

> Poll a launch session. Status moves created -> opened -> completed; sessions that pass their 48-hour expiry become expired. document_url is populated once the session is completed.



## OpenAPI

````yaml /developer-docs/api/openapi.json get /v1/partner/launch-sessions/{session_id}
openapi: 3.1.0
info:
  title: Everbility Public API
  version: 1.0.0
  description: >-
    Pull reports from Everbility, upload notes and files, poll asynchronous
    jobs, and generate reports from saved templates. Partner endpoints let
    approved platforms connect practices with OAuth 2.0, launch report-writing
    sessions, receive signed lifecycle webhooks, and retrieve completed
    documents.
servers:
  - url: https://api.everbility.com
    description: Production
security:
  - bearerAuth: []
paths:
  /v1/partner/launch-sessions/{session_id}:
    get:
      tags:
        - partner
      summary: Get Launch Session Status
      description: >-
        Poll a launch session. Status moves created -> opened -> completed;
        sessions that pass their 48-hour expiry become expired. document_url is
        populated once the session is completed.
      operationId: >-
        get_partner_launch_session_status_v1_partner_launch_sessions__session_id__get
      parameters:
        - name: session_id
          in: path
          required: true
          schema:
            type: string
            title: Session Id
      responses:
        '200':
          description: Current session status and timestamps.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PartnerLaunchSessionStatusResponse'
        '401':
          description: Invalid or expired access token, or the connection was revoked.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PartnerErrorResponse'
              example:
                detail: Invalid bearer token
        '404':
          description: >-
            Unknown session_id, or the session belongs to a different
            connection.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PartnerErrorResponse'
              example:
                detail: Session not found
      security:
        - partnerBearer: []
components:
  schemas:
    PartnerLaunchSessionStatusResponse:
      type: object
      title: PartnerLaunchSessionStatusResponse
      properties:
        session_id:
          type: string
          title: Session Id
        status:
          type: string
          enum:
            - created
            - opened
            - completed
            - expired
          title: Status
        created_at:
          type: string
          format: date-time
          title: Created At
        opened_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Opened At
        completed_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Completed At
        expires_at:
          type: string
          format: date-time
          title: Expires At
        document_url:
          anyOf:
            - type: string
            - type: 'null'
          title: Document Url
          description: Populated once the session is completed.
      required:
        - session_id
        - status
        - created_at
        - expires_at
      example:
        session_id: psess_Zl9nB1qFhOQe2kQ4rW8xJ3Ty
        status: completed
        created_at: '2026-07-06T04:15:00Z'
        opened_at: '2026-07-06T04:22:41Z'
        completed_at: '2026-07-06T05:03:12Z'
        expires_at: '2026-07-08T04:15:00Z'
        document_url: /v1/partner/launch-sessions/psess_Zl9nB1qFhOQe2kQ4rW8xJ3Ty/document
    PartnerErrorResponse:
      type: object
      title: PartnerErrorResponse
      properties:
        detail:
          type: string
          title: Detail
          description: Human-readable error code or message.
      required:
        - detail
      example:
        detail: Invalid authorization code
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: API Key
      description: >-
        Use a Clerk-backed Everbility user or organisation API key directly as
        the bearer token.
    partnerBearer:
      type: http
      scheme: bearer
      bearerFormat: Partner access token
      description: >-
        Opaque partner access token (pat_...) issued by POST
        /v1/partner/oauth/token. Access tokens last 1 hour; refresh with the
        90-day refresh token.

````