GET /sessions
Your live browser sessions, with their state and attestation, without their CDP addresses.
Syntax
GET https://grid-lab.zyxio.xyz/sessions
x-api-key: <key>Request
| Name | Where | Required | Meaning |
|---|---|---|---|
x-api-key | header | yes, or Authorization | Your API key, or Authorization: Bearer <token> from Zyxio sign-in. |
Response
200 OK, an array with one entry per session of this identity:
| Field | Meaning |
|---|---|
sessionId | The session's id. |
status | pending while the browser starts, running once it is ready. |
createdAt, expiresAt | When it was leased and when it ends at the latest. |
profileId | The profile you asked for. |
attestation | null while pending. When running: the browser product and version, the image digest, mode, locale, time zone, window and the launch manifest's hash. Its profileId must match yours. |
networkPolicy | The network policy you asked for, or null. |
networkAttestation | For a running session with a policy: proof from inside the session that the policy is enforced. Otherwise null. |
Wait for running with a matching attestation before you connect: only that tells you which browser is running.
Errors
| Status | Body | When | What to do |
|---|---|---|---|
401 | {"error": "unauthorized"} | No credential, or a key that is revoked, expired, wrong, or of a suspended account. | Send a valid key. |
503 | {"error": "accounting_unavailable"} | Your key or Zyxio sign-in could not be checked because the account database did not answer in time. Nothing was done. | Retry shortly; the same request is safe to resend. |
403 | {"error": "forbidden"} | A valid Zyxio sign-in token whose identity has no account here, or whose account is suspended. | Accept your invitation first, or use a key. |
503 | {"error": "sessions disabled"} | Sessions are switched off on the grid. | Try again later. |
Example
curl -s https://grid-lab.zyxio.xyz/sessions -H "x-api-key: $BROWSERGRID_API_KEY"[
{
"sessionId": "a1b2c3d4e5f6",
"createdAt": "2026-10-10T12:00:00.000Z",
"expiresAt": "2026-10-10T12:30:00.000Z",
"status": "pending",
"profileId": "desktop-chrome-nl/v2",
"attestation": null,
"networkPolicy": null,
"networkAttestation": null
}
]Billing
Free.
See also
Browser sessions, POST /sessions, DELETE /sessions/{sessionId}.