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

# Get Tool Logs

> Lists Web Search and Web Fetch request logs for the authenticated team within a time window. Optional `tool` filters by web-search or web-fetch. Uses the query rate limit (separate from tool call RPM).



## OpenAPI

````yaml /tools/logs.json get /v1/logs
openapi: 3.0.0
info:
  title: Modellix Web Tools Logs API
  version: 1.0.0
  description: List Web Search and Web Fetch request logs for the authenticated team.
servers:
  - url: https://tool.modellix.ai
security:
  - bearerAuth: []
paths:
  /v1/logs:
    get:
      summary: Get Tool Logs
      description: >-
        Lists Web Search and Web Fetch request logs for the authenticated team
        within a time window. Optional `tool` filters by web-search or
        web-fetch. Uses the query rate limit (separate from tool call RPM).
      operationId: listToolLogs
      parameters:
        - $ref: '#/components/parameters/LogsTool'
        - $ref: '#/components/parameters/LogsStartTime'
        - $ref: '#/components/parameters/LogsEndTime'
        - $ref: '#/components/parameters/LogsMdlxUserId'
        - $ref: '#/components/parameters/LogsPage'
        - $ref: '#/components/parameters/LogsPageSize'
      responses:
        '200':
          description: Paginated Web Search and Web Fetch request logs.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ToolLogsResponse'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '429':
          $ref: '#/components/responses/RateLimited'
        '502':
          $ref: '#/components/responses/BadGateway'
        '503':
          $ref: '#/components/responses/Unavailable'
components:
  parameters:
    LogsTool:
      name: tool
      in: query
      required: false
      description: Optional tool filter. Omit this parameter to return logs for all tools.
      schema:
        type: string
        enum:
          - web-search
          - web-fetch
    LogsStartTime:
      name: start_time
      in: query
      required: true
      description: Inclusive range start as a positive UNIX timestamp in seconds.
      schema:
        type: integer
        format: int64
        minimum: 1
    LogsEndTime:
      name: end_time
      in: query
      required: true
      description: >-
        Inclusive range end as a positive UNIX timestamp in seconds. It must be
        after start_time, at most 30 days later, and no more than one day in the
        future.
      schema:
        type: integer
        format: int64
        minimum: 1
    LogsMdlxUserId:
      name: mdlx_user_id
      in: query
      required: false
      description: Optional exact end-user identifier filter.
      schema:
        type: string
        minLength: 8
        maxLength: 128
        pattern: ^[A-Za-z0-9_-]+$
    LogsPage:
      name: page
      in: query
      required: false
      schema:
        type: integer
        minimum: 1
        default: 1
    LogsPageSize:
      name: page_size
      in: query
      required: false
      schema:
        type: integer
        minimum: 1
        maximum: 100
        default: 10
  schemas:
    ToolLogsResponse:
      type: object
      required:
        - requests
        - total
        - page
        - page_size
      properties:
        requests:
          type: array
          items:
            $ref: '#/components/schemas/ToolLogEntry'
        total:
          type: integer
          format: int64
          minimum: 0
        page:
          type: integer
          minimum: 1
        page_size:
          type: integer
          minimum: 1
          maximum: 100
    ToolLogEntry:
      type: object
      required:
        - request_id
        - tool_slug
        - source
        - status
        - error
        - http_status
        - error_code
        - input
        - result
        - warnings
        - created_at
        - duration
        - parent_request_id
        - tool_call_id
        - cost
        - sku
        - pricing_version
        - quantity
        - unit_amount_subpenny
        - currency
        - answer_status
        - has_answer
        - request_count
        - success_count
        - result_count
        - failed_count
      properties:
        request_id:
          type: string
        tool_slug:
          type: string
          enum:
            - modellix-ai/web-search
            - modellix-ai/web-fetch
        source:
          type: string
          description: Request origin
          example: rest
        status:
          type: string
          example: success
        error:
          type: string
        http_status:
          type: integer
          format: int32
        error_code:
          type: string
        input:
          description: >-
            Original tool input as JSON, or a string when the stored payload is
            not valid JSON.
          nullable: true
          oneOf:
            - type: object
            - type: string
        result:
          description: >-
            Tool result as JSON, or a string when the stored payload is not
            valid JSON.
          nullable: true
          oneOf:
            - type: object
            - type: string
        warnings:
          type: array
          nullable: true
          items:
            type: string
        created_at:
          type: integer
          format: int64
          description: UNIX timestamp in seconds.
        duration:
          type: integer
          format: int64
          description: Duration in milliseconds.
        parent_request_id:
          type: string
        tool_call_id:
          type: string
        cost:
          type: integer
          format: int64
          description: Total cost in sub-pennies.
        sku:
          type: string
        pricing_version:
          type: string
        quantity:
          type: integer
          format: int64
        unit_amount_subpenny:
          type: integer
          format: int64
        currency:
          type: string
        answer_status:
          type: string
        has_answer:
          type: boolean
        request_count:
          type: integer
          format: int32
        success_count:
          type: integer
          format: int32
        result_count:
          type: integer
          format: int32
        failed_count:
          type: integer
          format: int32
    ErrorEnvelope:
      type: object
      required:
        - error
      properties:
        error:
          type: object
          required:
            - code
            - message
            - request_id
          properties:
            code:
              type: string
            message:
              type: string
            request_id:
              type: string
  responses:
    BadRequest:
      description: Invalid request or required user identifier.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorEnvelope'
    Unauthorized:
      description: Missing or invalid API key.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorEnvelope'
    RateLimited:
      description: Team call RPM, query RPM, or concurrency limit exceeded.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorEnvelope'
    BadGateway:
      description: Analytics is unavailable or not configured.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorEnvelope'
    Unavailable:
      description: Pricing, platform, or upstream providers are unavailable.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorEnvelope'
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: Modellix API Key

````