---
title: "Get Status And Results"
method: GET
path: "/v1/research/tasks/{task_id}"
tags: ["Research"]
---

# Get Status And Results

`GET /v1/research/tasks/{task_id}`

Returns the current status (queued, running, succeeded, failed) and any results if completed.

## Path parameters

- `task_id` string, required

## Response `200`

Successful Response

- ResearchTaskStatusResponse — Response for getting research task status and results.
  - `task_id` string, required — Unique identifier for this research task
  - `view_url` string, required — URL to view task progress and results
  - `status` 'queued' | 'running' | 'succeeded' | 'failed', required — Current status of the research task
  - `result` string, nullable — Research results in markdown format if completed
  - `structured_result` union — If an output schema was provided, the result formatted as JSON matching that schema
    - object
    - unknown[]
      - unknown
  - `structured_output_status` 'not_requested' | 'pending' | 'succeeded' | 'failed', nullable — Whether structured output was requested, is still pending, succeeded, or failed
  - `created_at` string, date-time, nullable — When the task was created
  - `updates` DeveloperUpdate[] — List of updates/results from the research task
    - `id` string, required
    - `timestamp` integer, required
    - `content` string, required
    - `citations` Citation[]
      - `id` string, required
      - `url` string, required
      - `preview_data` object
    - `stats` DeveloperReplayStats
      - `num_tool_calls` integer
      - `num_mcp_tool_calls` integer
      - `num_webpages_read` integer
      - `num_navigator_steps` integer
      - `num_websites_visited` integer
      - `sec_saved` integer
    - `structured_result` union
      - object
      - unknown[]
        - unknown
    - `structured_output_status` 'not_requested' | 'pending' | 'succeeded' | 'failed', nullable
    - `header_image_url` string, nullable
  - `rejection_reason` 'insufficient_prepaid_balance' | 'budget_exceeded' | 'subscription_inactive'

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/yutori/apis/fastapi.md) · [All operations](https://skmtc.dev/yutori/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/yutori/fastapi/revisions/ef669f82d5bc/schema)