> ## 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. # Get Task > Get detailed task information including status, progress, steps, and file outputs. ## OpenAPI ````yaml cloud/openapi/v2.json get /tasks/{task_id} 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/{task_id}: get: tags: - Tasks summary: Get Task description: >- Get detailed task information including status, progress, steps, and file outputs. operationId: get_task_tasks__task_id__get parameters: - name: task_id in: path required: true schema: type: string format: uuid title: Task Id responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/TaskView' '404': description: Task not found content: application/json: schema: $ref: '#/components/schemas/TaskNotFoundError' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' security: - APIKeyHeader: [] components: schemas: TaskView: properties: id: type: string format: uuid title: ID description: Unique identifier for the task sessionId: type: string format: uuid title: Sessionid 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' title: Status description: Current status of the task execution 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: {} steps: items: $ref: '#/components/schemas/TaskStepView' type: array title: Steps output: anyOf: - type: string - type: 'null' title: Output description: Final output/result of the task outputFiles: items: $ref: '#/components/schemas/FileView' type: array title: Outputfiles 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 based on the agent's self-reported output (less reliable than the judge) 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 - steps - outputFiles title: TaskView description: View model for representing a task with its execution details TaskNotFoundError: properties: detail: type: string title: Detail default: Task not found type: object title: TaskNotFoundError description: Error response when a task is not found HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError 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). TaskStepView: properties: number: type: integer title: Number description: Sequential step number within the task memory: type: string title: Memory description: Agent's memory at this step evaluationPreviousGoal: type: string title: Evaluation Previous Goal description: Agent's evaluation of the previous goal completion nextGoal: type: string title: Next Goal description: The goal for the next step url: type: string title: URL description: Current URL the browser is on for this step screenshotUrl: anyOf: - type: string - type: 'null' title: Screenshot URL description: Optional URL to the screenshot taken at this step actions: items: type: string type: array title: Actions description: List of stringified json actions performed by the agent in this step type: object required: - number - memory - evaluationPreviousGoal - nextGoal - url - actions title: TaskStepView description: View model for representing a single step in a task's execution FileView: properties: id: type: string format: uuid title: ID description: Unique identifier for the output file fileName: type: string title: File Name description: Name of the output file type: object required: - id - fileName title: FileView description: View model for representing an output file generated by the agent 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 ````