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

# Retrieve run logs by AI contact

> Returns the run logs (tree structure with descendants) for a given AI contact, ordered by start time descending. Supports pagination over the root run logs.



## OpenAPI

````yaml /openapi.json get /api/public/run-logs
openapi: 3.0.0
info:
  title: Vambe AI API
  description: Vambe AI documentation
  version: '1.0'
  contact: {}
servers:
  - url: https://api.vambe.me
    description: Production Server
security: []
tags:
  - name: Vambe AI
    description: ''
paths:
  /api/public/run-logs:
    get:
      tags:
        - Run Logs
      summary: Retrieve run logs by AI contact
      description: >-
        Returns the run logs (tree structure with descendants) for a given AI
        contact, ordered by start time descending. Supports pagination over the
        root run logs.
      operationId: PublicRunLogV2Controller_getRunLogsByAiContact
      parameters:
        - name: x-api-key
          in: header
          description: API key required to authorize the request
          required: true
          schema:
            type: string
        - name: ai_contact_id
          required: true
          in: query
          description: UUID of the AI contact to fetch run logs for
          schema:
            type: string
        - name: page
          required: false
          in: query
          description: Page number (defaults to 1)
          schema:
            type: number
        - name: page_size
          required: false
          in: query
          description: Page size (defaults to 20, max 100)
          schema:
            type: number
      responses:
        '200':
          description: Run logs retrieved successfully.
        '404':
          description: AI contact not found.

````