> ## 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 Status

> Lightweight endpoint optimized for polling task status.

Returns only the task status, output, and cost without loading steps,
files, or session details. Use this endpoint for efficient polling
instead of GET /tasks/{task_id}.

Recommended polling pattern:
1. POST /tasks to create a task
2. Poll GET /tasks/{task_id}/status until status is 'finished' or 'stopped'
3. GET /tasks/{task_id} once at the end for full details including steps



## OpenAPI

````yaml cloud/openapi/v2.json get /tasks/{task_id}/status
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}/status:
    get:
      tags:
        - Tasks
      summary: Get Task Status
      description: >-
        Lightweight endpoint optimized for polling task status.


        Returns only the task status, output, and cost without loading steps,

        files, or session details. Use this endpoint for efficient polling

        instead of GET /tasks/{task_id}.


        Recommended polling pattern:

        1. POST /tasks to create a task

        2. Poll GET /tasks/{task_id}/status until status is 'finished' or
        'stopped'

        3. GET /tasks/{task_id} once at the end for full details including steps
      operationId: get_task_status_tasks__task_id__status_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/TaskStatusView'
        '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:
    TaskStatusView:
      properties:
        id:
          type: string
          format: uuid
          title: ID
          description: Unique identifier for the task
        status:
          $ref: '#/components/schemas/TaskStatus'
          title: Status
          description: Current status of the task
        output:
          anyOf:
            - type: string
            - type: 'null'
          title: Output
          description: Final output/result of the task (null while running)
        finishedAt:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Finished At
          description: Naive UTC timestamp when the task completed (null if still running)
        isSuccess:
          anyOf:
            - type: boolean
            - type: 'null'
          title: Is Success
          description: >-
            Whether the task was successful based on the agent's self-reported
            output
        cost:
          anyOf:
            - type: string
              pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
            - type: 'null'
          title: Cost
          description: Total cost of the task in USD
      type: object
      required:
        - id
        - status
      title: TaskStatusView
      description: >-
        Lightweight view optimized for polling. Use GET /tasks/{id}/status for
        efficient polling

        instead of GET /tasks/{id} which loads full step 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).
    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

````