> ## Documentation Index > Fetch the complete documentation index at: https://browseruse-0aece648-cursor-proxy-indicator-and-text-6cda.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # List Tasks > Get paginated list of AI agent tasks with optional filtering by session and status. ## OpenAPI ````yaml cloud/openapi/v2.json get /tasks openapi: 3.1.0 info: title: Browser Use Public API v2 summary: Browser Use API for running web agents (v2) version: 2.0.0 servers: - url: https://api.browser-use.com/api/v2 description: Production server security: [] paths: /tasks: get: tags: - Tasks summary: List Tasks description: >- Get paginated list of AI agent tasks with optional filtering by session and status. operationId: list_tasks_tasks_get parameters: - name: pageSize in: query required: false schema: type: integer maximum: 100 minimum: 1 default: 10 title: Pagesize - name: pageNumber in: query required: false schema: type: integer minimum: 1 default: 1 title: Pagenumber - name: sessionId in: query required: false schema: anyOf: - type: string format: uuid - type: 'null' title: Sessionid - name: filterBy in: query required: false schema: anyOf: - $ref: '#/components/schemas/TaskStatus' - type: 'null' title: Filterby - name: after in: query required: false schema: anyOf: - type: string format: date-time - type: 'null' title: After - name: before in: query required: false schema: anyOf: - type: string format: date-time - type: 'null' title: Before responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/TaskListResponse' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' security: - APIKeyHeader: [] components: schemas: TaskStatus: type: string enum: - created - started - finished - stopped title: TaskStatus description: |- Enumeration of possible task execution states Attributes: CREATED: Task has been created but not yet started. STARTED: Task has been started and is currently running. FINISHED: Task has finished and the agent has completed the task. STOPPED: Task execution has been manually stopped (cannot be resumed). TaskListResponse: properties: items: items: $ref: '#/components/schemas/TaskItemView' type: array title: Items description: List of task views for the current page totalItems: type: integer title: Total Items description: Total number of items in the list pageNumber: type: integer title: Page Number description: Page number pageSize: type: integer title: Page Size description: Number of items per page type: object required: - items - totalItems - pageNumber - pageSize title: TaskListResponse description: Response model for paginated task list requests. HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError TaskItemView: properties: id: type: string format: uuid title: ID description: Unique identifier for the task sessionId: type: string format: uuid title: Session ID description: ID of the session this task belongs to llm: type: string title: LLM description: The LLM model used for this task represented as a string task: type: string title: Task description: The task prompt/instruction given to the agent status: $ref: '#/components/schemas/TaskStatus' createdAt: type: string format: date-time title: Created At description: Naive UTC timestamp when the task was created startedAt: anyOf: - type: string format: date-time - type: 'null' title: Started At description: >- Naive UTC timestamp when the task was started (None if task has not started yet) finishedAt: anyOf: - type: string format: date-time - type: 'null' title: Finished At description: Naive UTC timestamp when the task completed (None if still running) metadata: additionalProperties: true type: object title: Metadata description: >- Optional additional metadata associated with the task set by the user default: {} output: anyOf: - type: string - type: 'null' title: Output description: Final output/result of the task browserUseVersion: anyOf: - type: string - type: 'null' title: Browser Use Version description: >- Version of browser-use used for this task (older tasks may not have this set) isSuccess: anyOf: - type: boolean - type: 'null' title: Is Success description: Whether the task was successful (self-reported by the agent) judgement: anyOf: - type: string - type: 'null' title: Judgement description: Stringified JSON object containing the full report from the judge judgeVerdict: anyOf: - type: boolean - type: 'null' title: Judge Verdict description: >- Judge verdict - True if the judge found the task to be successful, False otherwise (None if judge is not enabled) cost: anyOf: - type: string pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$ - type: 'null' title: Cost description: >- Total cost of the task in USD. This is the sum of all step costs incurred during task execution. suggestions: anyOf: - items: additionalProperties: true type: object type: array - type: 'null' title: Suggestions description: >- List of actionable suggestions for improving task configuration based on detected issues during execution. type: object required: - id - sessionId - llm - task - status - createdAt title: TaskItemView description: View model for representing a task with its execution details ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array title: Location msg: type: string title: Message type: type: string title: Error Type type: object required: - loc - msg - type title: ValidationError securitySchemes: APIKeyHeader: type: apiKey in: header name: X-Browser-Use-API-Key ````