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

# Get Task Run Status

> Get the status of a specific task run

<RequestExample>
  ```bash theme={null}
  curl --request GET \
    --url 'http://localhost:2003/api/v1/task/task_123/run/status?runId=run_456' \
    --header 'x-api-key: <your-api-key>'
  ```
</RequestExample>

<ResponseExample>
  ```json theme={null}
  {
    "success": true,
    "data": {
      "status": "running",
      "detailedStatus": "processing_page",
      "toolCall": null,
      "liveStatus": "<live url>"
    }
  }
  ```
</ResponseExample>


## OpenAPI

````yaml GET /task/{taskId}/run/status
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:
  /task/{taskId}/run/status:
    get:
      summary: Get Task Run Status
      description: Get the status of a specific task run
      parameters:
        - name: taskId
          in: path
          required: true
          description: The ID of the task
          schema:
            type: string
            example: task_123
        - name: runId
          in: query
          required: false
          description: >-
            The ID of the run. If not provided, returns status of the most
            recent run.
          schema:
            type: string
            example: run_456
      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: object
                    properties:
                      status:
                        type: string
                        enum:
                          - scheduled
                          - running
                          - completed
                          - error
                        description: High-level status of the task run
                        example: running
                      detailedStatus:
                        type: string
                        description: Detailed status information about the current state
                        example: processing_page
                      toolCall:
                        type: object
                        description: Information about any tool call being waited on
                        nullable: true
                        example: null
                      liveStatus:
                        type: object
                        description: >-
                          Real-time status information about the current
                          operation
                        example: <live url>
components:
  securitySchemes:
    apiKey:
      type: apiKey
      name: x-api-key
      in: header

````