---
title: "Get research task status and results"
method: GET
path: "/research/{request_id}"
---

# Get research task status and results

`GET /research/{request_id}`

Retrieve the status and results of a research task using its request ID.

## Path parameters

- `request_id` string, required

## Response `200`

Research task is completed or failed.

- union
  - ResearchTaskCompleted
    - `request_id` string, required — The unique identifier of the research task.
    - `created_at` string, required — Timestamp when the research task was created.
    - `status` 'completed', required — The current status of the research task.
    - `content` union, required — The research report content. Can be a string or a structured object if output_schema was provided.
      - string
      - object
    - `sources` object[], required — List of sources used in the research.
      - `title` string — Title or name of the source.
      - `url` string, uri — URL of the source.
      - `favicon` string, uri — URL to the source's favicon.
    - `response_time` integer, required — Time in seconds it took to complete the request.
  - ResearchTaskFailed
    - `request_id` string, required — The unique identifier of the research task.
    - `status` 'failed', required — The current status of the research task.
    - `response_time` integer, required — Time in seconds it took to complete the request.

## Other responses

- `202` — Research task is not yet completed (pending or in_progress).
- `401` — Unauthorized - Your API key is wrong or missing.
- `404` — Research task not found
- `500` — Internal Server Error - We had a problem with our server.

---

[API](https://skmtc.net/tavily/apis/tavily-search-and-extract-api.md) · [All operations](https://skmtc.net/tavily/apis/tavily-search-and-extract-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tavily/tavily-search-and-extract-api/versions/9126e7d2df75/schema)