> ## Documentation Index
> Fetch the complete documentation index at: https://docs.browserable.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# List Tasks

> Get a list of all tasks for the authenticated user

<RequestExample>
  ```bash theme={null}
  curl --request GET \
    --url 'http://localhost:2003/api/v1/tasks?page=1&limit=30' \
    --header 'x-api-key: <your-api-key>'
  ```
</RequestExample>

<ResponseExample>
  ```json theme={null}
  {
    "success": true,
    "data": [
      {
        "id": "task_123",
        "status": "active",
        "readable_name": "My Task"
      }
    ],
    "total": 1,
    "page": 1,
    "limit": 30
  }
  ```
</ResponseExample>


## OpenAPI

````yaml GET /tasks
openapi: 3.1.0
info:
  title: Browserable API
  description: API for managing automated browser tasks
  version: 1.0.0
servers:
  - url: https://api.browserable.ai/api/v1/
    description: API Server
security:
  - apiKey: []
paths:
  /tasks:
    get:
      summary: List Tasks
      description: Get a list of all tasks for the authenticated user
      parameters:
        - name: page
          in: query
          description: Page number for pagination
          schema:
            type: integer
            default: 1
            example: 1
        - name: limit
          in: query
          description: 'Number of tasks per page (max: 30)'
          schema:
            type: integer
            default: 30
            maximum: 30
            example: 30
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    description: Indicates if the request was successful
                    example: true
                  data:
                    type: array
                    description: Array of task objects
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                          description: Unique identifier for the task
                          example: task_123
                        status:
                          type: string
                          enum:
                            - active
                            - inactive
                          description: Current status of the task
                          example: active
                        readable_name:
                          type: string
                          description: Human-readable name of the task
                          example: My Task
                  total:
                    type: integer
                    description: Total number of tasks
                    example: 1
                  page:
                    type: integer
                    description: Current page number
                    example: 1
                  limit:
                    type: integer
                    description: Number of tasks per page
                    example: 30
                  error:
                    type: string
                    description: Error message if the request failed
components:
  securitySchemes:
    apiKey:
      type: apiKey
      name: x-api-key
      in: header

````