---
title: "Get web navigator task results"
method: POST
path: "/navigator/get-task"
tags: ["Navigator"]
---

# Get web navigator task results

`POST /navigator/get-task`

Get web navigator task results for a given task ID

## Request body

- object
  - `task_id` string, required — The ID of the task to retrieve

## Response `200`

GetTask API successful response

- object
  - `task` NavigatorTask
    - `task_id` string — The ID of the navigator task
    - `request` object
      - `url` string — The URL to start navigating from
      - `objective` string — The natural language objective of the navigation
    - `response` object
      - `html` string — The HTML string of the page that the navigator reached
      - `img` string — The base64-encoded string for screenshot of the page that the navigator reached
      - `markdown` string — The markdown string of the page that the navigator reached
    - `status` 'PENDING' | 'IN_PROGRESS' | 'SUCCEEDED' | 'FAILED' | 'TIMED_OUT' — The status of the navigator task
    - `start_time` string — The start time of the navigator task
    - `end_time` string — The end time of the navigator task
    - `last_updated_time` string — The last updated time of the navigator task

## Other responses

- `400` — User error response
- `500` — Server error response

## Changes

- **2024-11-05** `57c3c3ae1e29` — 3 breaking
  - the `task/end_time` response's property format changed from `date-time` to no format for status `200`
  - the `task/last_updated_time` response's property format changed from `date-time` to no format for status `200`
  - the `task/start_time` response's property format changed from `date-time` to no format for status `200`
- **2024-11-04** `f3aa0cdc2085` — 2 warning, 3 info
  - removed the optional property `task/response/page_html` from the response with the `200` status
  - removed the optional property `task/response/page_img` from the response with the `200` status
  - added the optional property `task/response/html` to the response with the `200` status
  - added the optional property `task/response/img` to the response with the `200` status
  - …1 more

[Change history](https://skmtc.dev/carvedai/apis/exfunc-apis/changes/navigator/get-task/post.md)

---

[API](https://skmtc.dev/carvedai/apis/exfunc-apis.md) · [All operations](https://skmtc.dev/carvedai/apis/exfunc-apis/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/carvedai/exfunc-apis/revisions/22587fdf9a5e/schema)