---
title: "List Tasks"
method: GET
path: "/v1/task"
tags: ["Tasks"]
---

# List Tasks

`GET /v1/task`

Retrieves a paginated list of all tasks for the authenticated team. Tasks are returned 
with their latest version information and metadata.

## Query parameters

- `page` string
- `limit` string

## Response `200`

List of tasks retrieved successfully

- TaskListResponse
  - `data` object
    - `tasks` Task[], required
      - `id` string, uuid, required — Unique identifier for the task
      - `name` string, required — Task name (letters, numbers, hyphens, and underscores only)
      - `teamId` string, uuid, required — Team identifier that owns this task
      - `description` string — Optional description of the task
      - `latestVersion` string, required — Latest version identifier (draft, latest, or version number)
      - `code` string, required — Base64 encoded task code
      - `language` 'typescript', required — Programming language for the task
      - `browserConfiguration` SessionConfig — Session-related configurations.
        - `initial_url` string, uri — The URL to navigate to when the browser session starts. If not provided, the browser will load an empty page.
        - `recording` object — Configuration for session recording.
          - `active` boolean — Enable or disable video recording of the browser session. Defaults to `true`.
        - `proxy` union — Proxy Documentation available at [Proxy Documentation](/advanced/proxy)
          - object
            - `active` boolean, required
            - `type` union — **On change make sure to update the country_code.**
              - …
            - `country_code` union — Supported country codes ISO 2 lowercase **On change make sure to update the Proxy type.**
              - …
            - `region` string — Region code for more specific geographic targeting. The city parameter can only be used when region is also provided.
            - `city` string — City name for precise geographic targeting. Supported for anchor_proxy only. Can only be used when region is also provided.
          - object
            - `type` 'custom', required
            - `server` string, required — Proxy server address
            - `username` string, required — Proxy username
            - `password` string, required — Proxy password
            - `active` boolean, required
        - `timeout` object — Timeout configurations for the browser session.
          - `max_duration` integer — Maximum amount of time (in minutes) for the browser to run before terminating. Defaults to `20`.
          - `idle_timeout` integer — The amount of time (in minutes) the browser session waits for new connections after all others are closed before stopping. Defaults to `5`.
        - `live_view` object — Configuration for live viewing the browser session.
          - `read_only` boolean — Enable or disable read-only mode for live viewing. Defaults to `false`.
      - `deleted` boolean, required — Whether the task is soft deleted
      - `createdAt` string, date-time, required — Task creation timestamp
      - `updatedAt` string, date-time, required — Task last update timestamp
    - `total` integer, required — Total number of tasks
    - `page` integer, required — Current page number
    - `limit` integer, required — Number of tasks per page

## Other responses

- `500` — Failed to list tasks

## Changes

- **2025-10-20** `918bcdcb6208` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/anchorbrowser/apis/anchorbrowser-api/changes/v1/task/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-service-production.skmtc.workers.dev/v1/apis/anchorbrowser/anchorbrowser-api/revisions/8f77fa55fe1f/schema)