Skip to main content
GET
/
browser
List browser sessions
curl --request GET \
  --url https://api.firecrawl.dev/v2/browser \
  --header 'Authorization: Bearer <token>'
{
  "success": true,
  "sessions": [
    {
      "id": "<string>",
      "status": "active",
      "cdpUrl": "<string>",
      "liveViewUrl": "<string>",
      "streamWebView": true,
      "createdAt": "2023-11-07T05:31:56Z",
      "lastActivity": "2023-11-07T05:31:56Z"
    }
  ]
}

​
Headers

HeaderValue
AuthorizationBearer <API_KEY>

​
Query Parameters

ParameterTypeRequiredDescription
statusstringNoFilter by session status: "active" or "destroyed"

​
Response

FieldTypeDescription
successbooleanWhether the request succeeded
sessionsarrayList of session objects

​
Session Object

FieldTypeDescription
idstringUnique session identifier
statusstringCurrent session status ("active" or "destroyed")
cdpUrlstringWebSocket URL for CDP connections
liveViewUrlstringURL to watch the session in real time
createdAtstringISO 8601 timestamp of session creation
lastActivitystringISO 8601 timestamp of last activity

​
Example Request

curl -X GET "https://api.firecrawl.dev/v2/browser?status=active" \
  -H "Authorization: Bearer $FIRECRAWL_API_KEY"

​
Example Response

{
  "success": true,
  "sessions": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "status": "active",
      "cdpUrl": "wss://cdp-proxy.firecrawl.dev/cdp/550e8400-e29b-41d4-a716-446655440000",
      "liveViewUrl": "https://liveview.firecrawl.dev/550e8400-e29b-41d4-a716-446655440000",
      "createdAt": "2025-06-01T12:00:00Z",
      "lastActivity": "2025-06-01T12:05:30Z"
    }
  ]
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

​
status
enum<string>

Filter sessions by status

Available options:
active,
destroyed

Response

List of browser sessions

​
success
boolean
​
sessions
object[]