List Browser Sessions

GET

/api/v1/cloud-browser/sessions

Requires a login JWT; API keys are not accepted. Lists sessions in the current personal or team scope. Lifecycle, state and search filters apply before pagination. Search covers saved information, not complete browsing history.

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

Authorization: ********************

Query Params

Header Params

Responses

🟢200

application/json

History lists use a five-second cache isolated by owner and all query parameters; identical concurrent reads share a query. active/all lists read current data.

Headers

Bodyapplication/json

🟠400

🟠401

🟠403

🟠404

🟠409

🟠410

🟠413

🟠422

🟠429

🟠470

🔴500

🔴503

⚪default

Request Example

Shell

JavaScript

Java

Swift

curl --location '/api/v1/cloud-browser/sessions?lifecycle=&failurePhase=&site=&page=&limit=&state=&search=' \
--header 'x-team-id;' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Example 1

{
    "data": {
        "searchCoverage": "name_id_target_url_and_indexed_rrweb_meta",
        "siteSearchCoverage": "indexed_rrweb_meta_host_only",
        "items": [
            {
                "failurePhase": "before_ready",
                "recordingAvailability": {
                    "state": "disabled",
                    "stale": true,
                    "observedAt": "2019-08-24T14:15:22.123Z",
                    "expiresAt": "2019-08-24T14:15:22.123Z",
                    "deletedAt": "2019-08-24T14:15:22.123Z",
                    "deleteRequestedAt": "2019-08-24T14:15:22.123Z",
                    "segmentCount": 0,
                    "readyDomSegmentCount": 0
                },
                "providerObservation": {
                    "observedAt": "2019-08-24T14:15:22.123Z",
                    "configurationRevision": 0,
                    "appliedFingerprintSha256": "string",
                    "networkIdentity": {
                        "observedAt": "2019-08-24T14:15:22.123Z",
                        "alignmentStatus": "aligned",
                        "ip": "string",
                        "countryCode": "string",
                        "locale": "string",
                        "timezone": "string",
                        "latitude": -90,
                        "longitude": -180,
                        "resolvedAt": "2019-08-24T14:15:22.123Z"
                    },
                    "timingsMs": {
                        "property1": 0,
                        "property2": 0
                    }
                },
                "effectiveConfiguration": {
                    "resourceClass": "string",
                    "ttlSeconds": 0,
                    "recording": true,
                    "maskInputs": true,
                    "proxyConfigured": true,
                    "proxyGeoIp": true,
                    "geoIpGeolocation": true,
                    "geoIpStatus": "disabled",
                    "fingerprint": {
                        "platform": "windows",
                        "kernelMilestone": "string",
                        "platformVersion": "string",
                        "resolution": "600x666",
                        "locale": "string",
                        "timezone": "string",
                        "userAgent": "string"
                    },
                    "extensions": [
                        {
                            "artifactId": "string",
                            "version": "string",
                            "enabled": true
                        }
                    ]
                },
                "warnings": [
                    "string"
                ],
                "captchaSolver": {
                    "enabled": false,
                    "types": {
                        "recaptchaV2": true,
                        "recaptchaV3": true,
                        "textCaptcha": true,
                        "awsCaptcha": true,
                        "cloudflareTurnstile": true
                    },
                    "artifactId": "string",
                    "version": "string"
                },
                "captchaEnabled": true,
                "source": "dash",
                "proxyRegion": "string",
                "captchaSuccesses": 0,
                "proxyTrafficBytes": "string",
                "navigationState": "pending",
                "navigationAttempts": 0,
                "navigationErrorCode": "string",
                "targetUrl": "string",
                "proxyCountry": "string",
                "sessionId": "string",
                "name": "string",
                "state": "creating",
                "resourceClass": "string",
                "region": "string",
                "ttlSeconds": 0,
                "recording": true,
                "maskInputs": true,
                "recordingId": "string",
                "readyAt": "2019-08-24T14:15:22.123Z",
                "expiresAt": "2019-08-24T14:15:22.123Z",
                "endedAt": "2019-08-24T14:15:22.123Z",
                "createdAt": "2019-08-24T14:15:22.123Z",
                "errorCode": "string",
                "endReason": "client_release",
                "billableStartedAt": "2019-08-24T14:15:22.123Z",
                "billableEndedAt": "2019-08-24T14:15:22.123Z",
                "billingState": "string",
                "usageSeconds": 0,
                "amount": "string",
                "ledgerId": "string"
            }
        ],
        "total": 0,
        "page": 0,
        "limit": 0
    },
    "err": false,
    "code": 200,
    "msg": "SUCCESS"
}

Modified at 2026-10-28 10:42:27

Create Browser Session

Get Session Details and Status