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

# Get Chatbot Session Transcript

> Conversation history for a `session_key`, plus the step currently waiting. Use it to read the result of a turn that returned `processing`.



## OpenAPI

````yaml get /external/chatbots/{chatbot_id}/sessions/{session_key}/messages
openapi: 3.1.0
info:
  title: Shieldbase External API
  description: Public API for Shieldbase AI integration
  version: 1.0.0
servers:
  - url: https://api.shieldbase.ai
    description: Production
  - url: http://localhost:8000
    description: Development
security:
  - ClientID: []
    APIKey: []
    Secret: []
paths:
  /external/chatbots/{chatbot_id}/sessions/{session_key}/messages:
    get:
      tags:
        - Chatbots
      summary: Get Chatbot Session Transcript
      description: >-
        Conversation history for a `session_key`, plus the step currently
        waiting. Use it to read the result of a turn that returned `processing`.
      parameters:
        - $ref: '#/components/parameters/TenantID'
        - name: chatbot_id
          in: path
          required: true
          schema:
            type: string
        - name: session_key
          in: path
          required: true
          schema:
            type: string
            maxLength: 200
      responses:
        '200':
          description: Transcript
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: object
                    properties:
                      chatbot_id:
                        type: string
                      session_key:
                        type: string
                      session_id:
                        type: string
                      messages:
                        type: array
                        items:
                          type: object
                          properties:
                            id:
                              type: string
                            role:
                              type: string
                            message:
                              type: string
                            step_id:
                              type:
                                - string
                                - 'null'
                            created_at:
                              type: string
                              format: date-time
                            file_urls:
                              type: array
                              items:
                                type: string
                      next_step:
                        $ref: '#/components/schemas/ChatbotStep'
        '404':
          description: Chatbot not found
components:
  parameters:
    TenantID:
      name: X-Tenant-ID
      in: header
      required: false
      description: >-
        Optional tenant selector for multitenant accounts. The API key owner
        must have access to the selected tenant.
      schema:
        type: string
  schemas:
    ChatbotStep:
      type:
        - object
        - 'null'
      description: >-
        The workflow step waiting for the next message. Informational only: you
        never need to send its ID back.
      properties:
        id:
          type: string
        type:
          type: string
        description:
          type: string
        expects:
          type: string
          enum:
            - message
            - form
            - choice
            - file
        form_fields:
          type: array
          description: Present when `expects` is `form`
          items:
            type: object
            properties:
              field:
                type: string
              description:
                type: string
              type:
                type: string
              required:
                type: boolean
              options: {}
        prompt:
          type: string
          description: Question for a choice step
        options:
          type: array
          items:
            type: string
          description: Present when `expects` is `choice`
  securitySchemes:
    ClientID:
      type: apiKey
      in: header
      name: X-Client-ID
    APIKey:
      type: apiKey
      in: header
      name: X-API-Key
    Secret:
      type: apiKey
      in: header
      name: X-Secret

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.