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

# Retrieve API logs

> Retrieve API call logs by API key and time range.



## OpenAPI

````yaml GET /api/v2/logs
openapi: 3.0.1
info:
  title: okey
  description: ''
  version: 1.0.0
servers:
  - url: https://api.okeyproxy.com/ipglobal-api
security: []
tags: []
paths:
  /api/v2/logs:
    get:
      tags: []
      summary: Retrieve API logs
      description: Retrieve API call logs by API key and time range.
      parameters:
        - name: apiKey
          in: query
          description: Agent API key used for authentication
          required: true
          example: ''
          schema:
            type: string
        - name: startTime
          in: query
          description: Start time, in yyyy-MM-dd HH:mm:ss format (UTC+8)
          required: true
          example: ''
          schema:
            type: string
        - name: endTime
          in: query
          description: End time, in yyyy-MM-dd HH:mm:ss format (UTC+8)
          required: true
          example: ''
          schema:
            type: string
        - name: page
          in: query
          description: 'Current page number (default: 1)'
          required: false
          schema:
            type: integer
            default: 1
        - name: pageSize
          in: query
          description: 'Number of records per page (default: 20, maximum: 100)'
          required: false
          schema:
            type: integer
            default: 20
            maximum: 100
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties:
                  logs:
                    type: array
                    items:
                      type: object
                      properties:
                        path:
                          type: string
                          description: Request path
                        status:
                          type: integer
                          title: ''
                          description: >-
                            HTTP status code. 200 for success, others for
                            errors.
                        method:
                          type: string
                          description: HTTP method
                        createTime:
                          type: string
                          title: ''
                          description: >-
                            Request timestamp. Format: yyyy-MM-dd HH:mm:ss
                            (UTC+8)
                      required:
                        - path
                        - status
                        - method
                        - createTime
                    title: API call log details
                  pagination:
                    type: object
                    properties:
                      currentPage:
                        type: integer
                        description: Current page number
                      pageSize:
                        type: integer
                        description: Number of records per page
                      totalRecords:
                        type: integer
                        description: Total records
                      totalPages:
                        type: integer
                        description: Total pages
                    required:
                      - currentPage
                      - pageSize
                      - totalRecords
                      - totalPages
                    title: Pagination metadata
                required:
                  - logs
                  - pagination
              example:
                logs:
                  - path: /api/v2/secUser/edit
                    status: 200
                    method: POST
                    createTime: '2025-01-01 18:20:24'
                pagination:
                  currentPage: 1
                  pageSize: 10
                  totalRecords: 1
                  totalPages: 1
          headers: {}
      deprecated: false
      security: []

````