---
title: "Async Session Status"
method: GET
path: "/v1/sessions/async/{request_id}/status"
tags: ["Browser Sessions"]
---

# Async Session Status

`GET /v1/sessions/async/{request_id}/status`

## Request

- Base URL: `https://api.anchorbrowser.io`
- URL: `https://api.anchorbrowser.io/v1/sessions/async/{request_id}/status`
- Auth: API key in header `anchor-api-key`

Polling endpoint paired with `POST /v1/sessions/async`. Returns the
current lifecycle `status` of the async request and, once the pod is
up, the embedded `session` object containing `session_id`, `cdp_url`
and `live_view_url`.

## Path parameters

- `request_id` string, uuid, required

## Response `200`

Async session status retrieved successfully.

- AsyncSessionStatusResponseSchema: Polling response for `GET /v1/sessions/async/{request_id}/status`.
  - `data` object
    - `request_id` string, uuid, required: The `request_id` returned from `POST /v1/sessions/async`.
    - `status` 'pending' | 'processing' | 'ready' | 'completed' | 'failed' | 'cancelled', required: Lifecycle of the async request itself. `ready` is surfaced once the underlying browser pod is up and the session is connectable.
    - `created_at` string, date-time, required: When the async request was accepted.
    - `session` BatchSessionItemSchema
      - `item_index` integer: Index of this session within the batch (0-based)
      - `session_id` string, uuid: Unique identifier for the browser session (if created successfully)
      - `status` 'pending' | 'processing' | 'completed' | 'failed' | 'cancelled': Current status of this individual session
      - `cdp_url` string: CDP websocket connection URL (if session is ready)
      - `live_view_url` string: Live view URL for the session (if session is ready)
      - `error` string: Error message if session creation failed
      - `retry_count` integer: Number of times this session creation has been retried
      - `started_at` string, date-time: Timestamp when session creation started
      - `completed_at` string, date-time: Timestamp when session creation completed
      - `metadata` object: Session-specific metadata
    - `progress` object, required
      - `current_phase` 'queued' | 'provisioning' | 'configuring' | 'ready', required: The session's current pod-provisioning phase.

## Other responses

- `401`: Invalid API Key.
- `404`: Async request not found.
- `500`: Internal server error.

## Changes

- **2026-10-16** `b3bfdb98c79e`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/anchorbrowser/apis/anchorbrowser-api/changes/v1/sessions/async/:request_id/status/get.md)

---

[API](https://skmtc.dev/anchorbrowser/apis/anchorbrowser-api.md) - [All operations](https://skmtc.dev/anchorbrowser/apis/anchorbrowser-api/llms.txt) - [OpenAPI document](https://skmtc.dev/anchorbrowser/apis/anchorbrowser-api/revisions/9d755f22df0e?raw)