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

# Fetch multiple conversations

> Fetch multiple conversation transcripts in one request using roomId + uuid pairs. Intended for logs -> conversation workflows where each item comes from /api/v2/logs.



## OpenAPI

````yaml post /api/v2/conversation/batch
openapi: 3.0.0
info:
  version: 2.0.0
  title: Vida API
  description: Vida API Documentation
servers:
  - url: https://api.vida.dev
    description: Vida Production
    variables:
      baseUrl:
        default: api.vida.dev
        description: Production API Root
security: []
paths:
  /api/v2/conversation/batch:
    post:
      tags:
        - Messaging
      summary: Fetch multiple conversations
      description: >-
        Fetch multiple conversation transcripts in one request using roomId +
        uuid pairs. Intended for logs -> conversation workflows where each item
        comes from /api/v2/logs.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - items
              properties:
                items:
                  description: List of conversation lookup items (max 200).
                  type: array
                  items:
                    type: object
                    required:
                      - roomId
                      - uuid
                    properties:
                      roomId:
                        description: Conversation room ID.
                        type: string
                        example: '2236859:2550714'
                      uuid:
                        description: >-
                          Conversation UUID from logs. Supports call format
                          {uuid}:{timestamp} or message format
                          {uuid}:{openTimestamp}:{closeTimestamp}.
                        type: string
                        example: bf0011ed-8175-458a-8fba-1e62ddc77567:1770763782
            example:
              items:
                - roomId: '2236859:2550714'
                  uuid: bf0011ed-8175-458a-8fba-1e62ddc77567:1770763782
                - roomId: '2236859:2535655'
                  uuid: edf65410-9f78-4d5e-82d2-2ee773ad4a49:1770765260
      responses:
        '200':
          description: Batch lookup complete. Each item includes per-item success/failure.
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: true
                  message:
                    type: string
                    example: Success
                  stats:
                    type: object
                    properties:
                      requested:
                        type: number
                        example: 2
                      ok:
                        type: number
                        example: 2
                      failed:
                        type: number
                        example: 0
                  results:
                    type: array
                    items:
                      type: object
                      properties:
                        success:
                          type: boolean
                          example: true
                        roomId:
                          type: string
                          example: '2236859:2550714'
                        uuid:
                          type: string
                          example: bf0011ed-8175-458a-8fba-1e62ddc77567:1770763782
                        message:
                          type: string
                          example: Success
                        conversation:
                          type: array
                          items:
                            type: object
                            additionalProperties: true
        '400':
          description: Invalid request body (e.g., missing items or too many items).
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: false
                  message:
                    type: string
                    example: items array is required
        '401':
          description: Unauthorized request.
          content:
            application/json:
              schema:
                type: string
                example: Unauthorized Request
      security:
        - apiKeyAuth: []
components:
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: query
      name: token
      description: Vida API Token

````