Skip to main content
GET
/
v1
/
browser
/
usage
List browser session usage
curl --request GET \
  --url https://api.browser.tinyfish.ai/v1/browser/usage \
  --header 'X-API-Key: <api-key>'
{
  "items": [
    {
      "session_id": "tf-a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "user_id": "cus_abc123",
      "sub_user_id": "user_abc123",
      "mode": "tf-browser",
      "start_time": "2026-03-18T16:18:35Z",
      "end_time": "2026-03-18T16:28:36Z",
      "duration_ms": 600543,
      "proxy_trg_rx_bytes": 38006,
      "proxy_trg_tx_bytes": 952337,
      "status": "ended",
      "created_at": "2026-03-18T16:18:12Z",
      "updated_at": "2026-03-18T16:28:36Z"
    }
  ],
  "total": 1,
  "limit": 100,
  "page": 1,
  "total_pages": 1,
  "has_more": false
}

Authorizations

​
X-API-Key
string
header
required

API key for authentication. Get your key from the API Keys page.

Query Parameters

​
session_id
string
​
start_after
string<date-time>
​
end_before
string<date-time>
​
status
enum<string>
Available options:
running,
ended
​
limit
integer
default:100
Required range: 1 <= x <= 1000
​
page
integer
default:1
Required range: x >= 1

Response

Browser usage retrieved successfully.

Paginated browser usage response

​
items
object[]
required
​
total
integer
required
​
limit
integer
required
​
page
integer
required
​
total_pages
integer
required
​
has_more
boolean
required