---
title: "Get Usage Logs"
method: GET
path: "/usage/logs"
tags: ["usage"]
---

# Get Usage Logs

`GET /usage/logs`

## Query parameters

- `endpoint` '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.duplicate' | 'profiles.get' | 'profiles.list' | 'profiles.delete' | 'profiles.cookies.set' | 'profiles.cookies.get' | '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.download' | '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', nullable — The endpoint to filter logs by
- `page` integer — Page number
- `page_size` integer — Number of items per page
- `only_active` boolean — Whether to only return active sessions
- `only_current_token` boolean — Whether to only return sessions for the current token (apikey)
- `include_system` boolean — Whether to include internal system sessions

## Headers

- `x-notte-request-origin` string, nullable
- `x-notte-sdk-version` string, nullable

## Response `200`

Successful Response

- PaginatedResponseUsageLog
  - `items` UsageLog[], required
    - `created_at` string, date-time, required
    - `duration_ms` integer, required
    - `endpoint` string, required
  - `page` integer, required
  - `page_size` integer, required
  - `has_next` boolean, required
  - `has_previous` boolean, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/notte/apis/notte-api.md) · [All operations](https://skmtc.net/notte/apis/notte-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/notte/notte-api/revisions/246f6d21de0c/schema)