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

# Get bot status and results

> Check the status of a bot session and retrieve results (transcript, Q&A pairs, insights) when the bot has finished.



## OpenAPI

````yaml /pailflow/api-reference/openapi.json get /api/bot/{bot_id}/status
openapi: 3.0.1
info:
  title: PailFlow API
  description: API for adding AI bots to video meetings
  version: 0.1.0
servers: []
security:
  - bearerAuth: []
paths:
  /api/bot/{bot_id}/status:
    get:
      summary: Get bot status and results
      description: >-
        Check the status of a bot session and retrieve results (transcript, Q&A
        pairs, insights) when the bot has finished.
      operationId: getBotStatus
      parameters:
        - name: bot_id
          in: path
          required: true
          description: The bot ID returned from POST /api/bot/join
          schema:
            type: string
            format: uuid
          example: 258b06fc-6bc9-4261-9f29-bc8a4474af0a
      responses:
        '200':
          description: Bot status and results
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                    enum:
                      - running
                      - completed
                      - failed
                    description: Current bot status
                  bot_id:
                    type: string
                    format: uuid
                  room_url:
                    type: string
                  started_at:
                    type: string
                    format: date-time
                    nullable: true
                    description: When the bot started
                  completed_at:
                    type: string
                    format: date-time
                    nullable: true
                    description: When the bot finished
                  transcript:
                    type: string
                    nullable: true
                    description: Full transcript text (available when completed)
                  qa_pairs:
                    type: array
                    nullable: true
                    description: >-
                      Q&A pairs extracted from transcript (available when
                      completed)
                    items:
                      type: object
                  insights:
                    type: object
                    nullable: true
                    description: AI-generated insights (available when completed)
                  error:
                    type: string
                    nullable: true
                    description: Error message if bot failed
              examples:
                running:
                  summary: Bot is still running
                  value:
                    status: running
                    bot_id: 258b06fc-6bc9-4261-9f29-bc8a4474af0a
                    room_url: https://your-domain.daily.co/your-room
                    started_at: '2025-01-15T10:00:00Z'
                completed:
                  summary: Bot has completed
                  value:
                    status: completed
                    bot_id: 258b06fc-6bc9-4261-9f29-bc8a4474af0a
                    room_url: https://your-domain.daily.co/your-room
                    started_at: '2025-01-15T10:00:00Z'
                    completed_at: '2025-01-15T10:30:00Z'
                    transcript: Full transcript text here...
                    qa_pairs:
                      - question: What was discussed in the meeting?
                        answer: >-
                          The team discussed project timelines and
                          deliverables...
                    insights:
                      summary: >-
                        Meeting covered key project milestones and action
                        items...
        '404':
          description: Bot session not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                error: not_found
                detail: Bot session 258b06fc-6bc9-4261-9f29-bc8a4474af0a not found
components:
  schemas:
    Error:
      type: object
      properties:
        error:
          type: string
          description: Error type
        detail:
          type: string
          description: Error detail message
        message:
          type: string
          description: User-friendly error message
        balance:
          type: number
          description: Current account balance (for insufficient_credits errors)
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: Your API key from pailflow.com

````