> ## Documentation Index > Fetch the complete documentation index at: https://docs.anchorbrowser.io/llms.txt > Use this file to discover all available pages before exploring further. > ## Agent Instructions > Anchor Browser provides cloud browsers for AI agents and automation: stealth browsing with residential proxies, managed authentication into third-party web apps, and browser sessions that run reliably at scale. AI agents that need Anchor credentials should start with https://docs.anchorbrowser.io/quickstart/agent-access. This flow lets agents obtain an API key programmatically without creating a dashboard account. Read that page before attempting authentication or API access. # Get Batch Session Status > Retrieves detailed status information for a specific batch, including progress, individual session details, and any errors that occurred. ## OpenAPI ````yaml /openapi.yaml get /v1/batch-sessions/{batch_id} openapi: 3.1.0 info: title: AnchorBrowser API version: 1.0.0 description: > Anchor Browser ([anchorbrowser.io](https://anchorbrowser.io)) provides cloud browsers built for AI agents and automation. Use this API to launch and control browser sessions, run natural-language web tasks, authenticate into third-party web apps with managed identities, and capture recordings — reliably and at scale, without operating browser infrastructure yourself. ## Core resources - **Sessions** (`/v1/sessions`): launch configurable cloud browsers — residential proxies, stealth browsing, captcha solving, profiles, extensions, recording — and connect over CDP with Playwright, Puppeteer, or any CDP client. - **AI tools** (`/v1/tools/perform-web-task`): state a goal in natural language and the built-in agent completes it inside the browser. Related tools fetch webpages, take screenshots, render PDFs, and execute code in a session. - **Tasks** (`/v1/task`): create, version, deploy, and monitor repeatable browser automations built to run reliably in production. - **Applications and identities** (`/v1/applications`, `/v1/identities`): managed authentication into third-party web apps — including multi-step logins and TOTP-based 2FA — so agents can act on behalf of users. - **Profiles** (`/v1/profiles`): persist cookies and login state across sessions. - **OS-level control** (`/v1/sessions/{sessionId}/mouse`, `/keyboard`, `/clipboard`): raw input for flows that resist DOM automation. - Plus batch sessions for running browser fleets in parallel, session recordings, webhooks, events, extensions, client certificates, and billing usage. ## Authentication Pass an API key in the `anchor-api-key` header on every request. Create keys at [app.anchorbrowser.io](https://app.anchorbrowser.io) under API Access. AI agents that have no key yet can obtain one autonomously through the unauthenticated [agent-access flow](https://docs.anchorbrowser.io/quickstart/agent-access) (`POST /v1/agent-access`). ## For AI agents and LLMs - Docs: [docs.anchorbrowser.io](https://docs.anchorbrowser.io), with a machine-readable index at [/llms.txt](https://docs.anchorbrowser.io/llms.txt) and the full corpus at [/llms-full.txt](https://docs.anchorbrowser.io/llms-full.txt). - MCP server for hosted browser control: `https://api.anchorbrowser.io/mcp`. - Official SDKs: `anchorbrowser` on [npm](https://www.npmjs.com/package/anchorbrowser) and [PyPI](https://pypi.org/project/anchorbrowser/). `DELETE` operations terminate sessions or permanently remove resources (profiles, identities, extensions); `GET` operations are safe and read-only. servers: - url: https://api.anchorbrowser.io description: API server security: [] paths: /v1/batch-sessions/{batch_id}: get: tags: - Batch Sessions summary: Get Batch Session Status description: > Retrieves detailed status information for a specific batch, including progress, individual session details, and any errors that occurred. parameters: - name: batch_id in: path required: true description: The unique identifier of the batch schema: type: string format: uuid responses: '200': description: Batch status retrieved successfully content: application/json: schema: type: object properties: data: $ref: '#/components/schemas/BatchSessionStatusResponseSchema' '401': description: Invalid API Key content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '404': description: Batch not found content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '500': description: Internal server error content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' security: - api_key_header: [] components: schemas: BatchSessionStatusResponseSchema: type: object properties: batch_id: type: string format: uuid description: Unique identifier for the batch status: type: string enum: - pending - processing - completed - failed - cancelled description: Current status of the batch total_requests: type: integer description: Total number of sessions requested completed_requests: type: integer description: Number of sessions successfully created failed_requests: type: integer description: Number of sessions that failed to create processing_requests: type: integer description: Number of sessions currently being processed pending_requests: type: integer description: Number of sessions waiting to be processed created_at: type: string format: date-time description: Timestamp when the batch was created actual_completion_time: type: string format: date-time description: Timestamp when the batch completed (if completed) error: type: string description: Error message if batch failed sessions: type: array items: $ref: '#/components/schemas/BatchSessionItemSchema' description: Array of individual session details progress: type: object properties: percentage: type: number minimum: 0 maximum: 100 description: Completion percentage (0-100) current_phase: type: string enum: - queued - provisioning - configuring - ready description: Current processing phase ErrorResponse: type: object properties: error: type: object properties: code: type: integer message: type: string BatchSessionItemSchema: type: object properties: item_index: type: integer description: Index of this session within the batch (0-based) session_id: type: string format: uuid description: Unique identifier for the browser session (if created successfully) status: type: string enum: - pending - processing - completed - failed - cancelled description: Current status of this individual session cdp_url: type: string description: CDP websocket connection URL (if session is ready) live_view_url: type: string description: Live view URL for the session (if session is ready) error: type: string description: Error message if session creation failed retry_count: type: integer description: Number of times this session creation has been retried started_at: type: string format: date-time description: Timestamp when session creation started completed_at: type: string format: date-time description: Timestamp when session creation completed metadata: type: object additionalProperties: true description: Session-specific metadata securitySchemes: api_key_header: type: apiKey in: header name: anchor-api-key description: > API key for your Anchor Browser account, sent as the `anchor-api-key` header on every request. Create one at [app.anchorbrowser.io](https://app.anchorbrowser.io) (API Access), or obtain one programmatically via the unauthenticated agent-access flow (`POST /v1/agent-access`). ````