Skip to main content
GET
/
v1
/
sessions
List Sessions
curl --request GET \
  --url https://api.example.com/v1/sessions

​
List Sessions

Retrieve all active sessions for the authenticated account.
​
status
string
Filter by status: launching, ready, active, idle.
​
limit
integer
default:"20"
Maximum number of results (1-100).
​
cursor
string
Cursor for pagination (from previous response’s nextCursor).

​
Request

curl "https://api.meshbrow.dev/v1/sessions?status=active&limit=10" \
  -H "Authorization: Bearer mb_live_..."

​
Response

200
{
  "items": [
    {
      "id": "ses_k8m2n4p6",
      "status": "active",
      "proxy": { "type": "residential", "country": "US" },
      "createdAt": "2026-10-27T14:00:00Z",
      "expiresAt": "2026-10-27T14:30:00Z"
    },
    {
      "id": "ses_j7l1m3o5",
      "status": "active",
      "proxy": { "type": "isp", "country": "GB" },
      "createdAt": "2026-10-27T13:45:00Z",
      "expiresAt": "2026-10-27T14:45:00Z"
    }
  ],
  "hasMore": false,
  "total": 2
}