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

# Get request logs

> Returns paginated request logs with optional filters.



## OpenAPI

````yaml /openapi.json get /dashboard/logs
openapi: 3.0.3
info:
  title: AtlasFlux API
  description: >-
    Unified AI model routing API with intelligent model selection, web search,
    reasoning, and prepaid MYR billing.
  version: 1.0.0
  contact:
    name: Rainspeed Labs
    url: https://atlasflux.my
  license:
    name: Proprietary
servers:
  - url: https://api.atlasflux.my
    description: Production
security:
  - apiKeyAuth: []
paths:
  /dashboard/logs:
    get:
      tags:
        - Dashboard — Logs
      summary: Get request logs
      description: Returns paginated request logs with optional filters.
      operationId: getLogs
      parameters:
        - name: from
          in: query
          schema:
            type: string
            format: date-time
        - name: to
          in: query
          schema:
            type: string
            format: date-time
        - name: status
          in: query
          schema:
            type: string
            enum:
              - pending
              - succeeded
              - failed
              - billed
        - name: endpoint
          in: query
          schema:
            type: string
        - name: page
          in: query
          schema:
            type: integer
            default: 1
        - name: limit
          in: query
          schema:
            type: integer
            default: 50
            maximum: 200
      responses:
        '200':
          description: Request logs.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/LogsResponse'
        '401':
          $ref: '#/components/responses/Unauthorized'
      security:
        - clerkAuth: []
components:
  schemas:
    LogsResponse:
      type: object
      properties:
        logs:
          type: array
          items:
            $ref: '#/components/schemas/LogEntry'
        total:
          type: integer
        has_more:
          type: boolean
    LogEntry:
      type: object
      properties:
        requestId:
          type: string
        publicModel:
          type: string
        endpoint:
          type: string
        status:
          type: string
        inputTokens:
          type: integer
        outputTokens:
          type: integer
        reasoningTokens:
          type: integer
        cachedTokens:
          type: integer
        searchCount:
          type: integer
        costMicroMyr:
          type: integer
        latencyMs:
          type: integer
          nullable: true
        createdAt:
          type: string
    ErrorResponse:
      type: object
      required:
        - type
        - error
      properties:
        type:
          type: string
          enum:
            - error
        error:
          type: object
          required:
            - message
            - type
            - code
            - param
            - request_id
            - guidance
            - action_url
            - retryable
          properties:
            message:
              type: string
            type:
              type: string
            code:
              type: string
              enum:
                - invalid_request
                - authentication_error
                - invalid_api_key
                - expired_api_key
                - revoked_api_key
                - permission_denied
                - insufficient_balance
                - spend_limit_exceeded
                - rate_limit_exceeded
                - context_length_exceeded
                - unsupported_input
                - provider_unavailable
                - provider_timeout
                - search_error
                - billing_error
                - idempotency_conflict
                - not_implemented
                - internal_error
            param:
              type: string
              nullable: true
            request_id:
              type: string
            guidance:
              type: string
            action_url:
              type: string
              format: uri
              nullable: true
            retryable:
              type: boolean
            retry_after_seconds:
              type: integer
              minimum: 0
  responses:
    Unauthorized:
      description: Missing or invalid API key.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
  securitySchemes:
    apiKeyAuth:
      type: http
      scheme: bearer
      bearerFormat: af_live_... or af_test_...
      description: AtlasFlux API key. Get yours from the Developer Dashboard.
    clerkAuth:
      type: http
      scheme: bearer
      bearerFormat: Clerk JWT
      description: Clerk session token. Used by the Developer Dashboard.

````

## Related topics

- [API Reference](/api-reference/overview.md)
- [Get usage data](/api-reference/dashboard-—-usage/get-usage-data.md)
- [Get dashboard overview](/api-reference/dashboard-—-overview/get-dashboard-overview.md)
- [Get transaction history](/api-reference/dashboard-—-billing/get-transaction-history.md)
- [Get billing balance](/api-reference/dashboard-—-billing/get-billing-balance.md)