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

# Get Usage Logs



## OpenAPI

````yaml https://api.notte.cc/openapi.json get /usage/logs
openapi: 3.1.0
info:
  title: Notte API
  description: >-
    Notte API is a REST API that allows you to interact with Notte. It is used
    to create cloud browser sessions, scrape webpages, and run web ai agents to
    act on your behalf on the internet.
  version: 1.4.40
  x-logo:
    url: https://www.notte.cc/images/logo/logo-white.png
servers: []
security: []
tags:
  - name: agents
    description: Web AI agents (start, stop, status, replay, etc.)
  - name: sessions
    description: Session management (start, stop, status, etc.)
  - name: debug
    description: Session debugging tools (replay,logs, recording, etc.)
  - name: page
    description: Page operations withing a session (observe, step, scrape, etc.)
  - name: storage
    description: File storage interface (upload, download, list, etc.)
  - name: network
    description: Network requests/responses withing a session (intercept, etc.)
  - name: vaults
    description: >-
      Vault & Credentials management (create/delete vaults, create/delete
      credentials, etc.)
  - name: personas
    description: Persona management (create, delete, list emails, list sms, etc.)
  - name: scrape
    description: >-
      Webpage scraping (scrape, screenshot, etc.) with automatic session
      management.
  - name: health
    description: Health check endpoint.
  - name: usage
    description: Usage logs (usage, logs, etc.)
  - name: functions
    description: Functions management (create, delete, list, etc.)
paths:
  /usage/logs:
    get:
      tags:
        - usage
      summary: Get Usage Logs
      operationId: get_usage_logs
      parameters:
        - name: endpoint
          in: query
          required: false
          schema:
            anyOf:
              - enum:
                  - sessions.start
                  - sessions.stop
                  - sessions.status
                  - sessions.cookies.set
                  - sessions.cookies.get
                  - sessions.list
                  - sessions.replay
                  - sessions.offset
                  - sessions.debug.info
                  - sessions.debug.info.tab
                  - sessions.debug.recording.wss
                  - sessions.debug.log.wss
                  - sessions.debug.tab.wss
                  - sessions.debug.browser.wss
                  - sessions.network.logs
                  - sessions.script
                  - page.observe
                  - page.execute
                  - page.scrape
                  - profiles.create
                  - profiles.get
                  - profiles.list
                  - profiles.delete
                  - vaults.create
                  - vaults.list
                  - vaults.delete
                  - vaults.update
                  - vaults.credentials.add
                  - vaults.credentials.get
                  - vaults.credentials.delete
                  - vaults.credentials.list
                  - vaults.credit_card.set
                  - vaults.credit_card.get
                  - vaults.credit_card.delete
                  - personas.create
                  - personas.list
                  - personas.delete
                  - personas.emails
                  - personas.sms
                  - personas.number.create
                  - personas.get
                  - storage.download
                  - storage.download.list
                  - storage.fbdownload
                  - storage.download.fblist
                  - storage.upload
                  - storage.upload.list
                  - agents.start
                  - agents.stop
                  - agents.status
                  - agents.list
                  - agents.replay
                  - agents.debug.recording
                  - agents.save
                  - agents.repeat
                  - agents.script
                  - bua
                  - scrape
                  - scrape_from_html
                  - search
                  - usage
                  - workflows.upload
                  - workflows.download
                  - workflows.list
                  - workflows.delete
                  - workflows.update
                  - workflows.fork
                  - workflows.schedule.create
                  - workflows.schedule.delete
                  - workflows.runs.create
                  - workflows.runs.start
                  - workflows.runs.get
                  - workflows.runs.list
                  - workflows.runs.update
                  - workflows.runs.stop
                type: string
              - type: 'null'
            description: The endpoint to filter logs by
            title: Endpoint
          description: The endpoint to filter logs by
        - name: page
          in: query
          required: false
          schema:
            type: integer
            minimum: 1
            description: Page number
            default: 1
            title: Page
          description: Page number
        - name: page_size
          in: query
          required: false
          schema:
            type: integer
            maximum: 100
            minimum: 1
            description: Number of items per page
            default: 10
            title: Page Size
          description: Number of items per page
        - name: only_active
          in: query
          required: false
          schema:
            type: boolean
            description: Whether to only return active sessions
            default: true
            title: Only Active
          description: Whether to only return active sessions
        - name: only_current_token
          in: query
          required: false
          schema:
            type: boolean
            description: Whether to only return sessions for the current token (apikey)
            default: false
            title: Only Current Token
          description: Whether to only return sessions for the current token (apikey)
        - name: x-notte-request-origin
          in: header
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            title: X-Notte-Request-Origin
        - name: x-notte-sdk-version
          in: header
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            title: X-Notte-Sdk-Version
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PaginatedResponse_UsageLog_'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
        - OAuth2PasswordBearer: []
components:
  schemas:
    PaginatedResponse_UsageLog_:
      properties:
        items:
          items:
            $ref: '#/components/schemas/UsageLog'
          type: array
          title: Items
        page:
          type: integer
          title: Page
        page_size:
          type: integer
          title: Page Size
        has_next:
          type: boolean
          title: Has Next
        has_previous:
          type: boolean
          title: Has Previous
          readOnly: true
      type: object
      required:
        - items
        - page
        - page_size
        - has_next
        - has_previous
      title: PaginatedResponse[UsageLog]
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    UsageLog:
      properties:
        created_at:
          type: string
          format: date-time
          title: Created At
        duration_ms:
          type: integer
          title: Duration Ms
        endpoint:
          type: string
          title: Endpoint
      type: object
      required:
        - created_at
        - duration_ms
        - endpoint
      title: UsageLog
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
  securitySchemes:
    OAuth2PasswordBearer:
      type: oauth2
      flows:
        password:
          scopes: {}
          tokenUrl: token

````