---
title: "Get research task status"
method: GET
path: "/web_search/research/{task_id}"
tags: ["Research"]
---

# Get research task status

`GET /web_search/research/{task_id}`

## Request

- Base URL: `https://api.telnyx.com/v2`
- URL: `https://api.telnyx.com/v2/web_search/research/{task_id}`
- Auth: HTTP bearer

Polls the status of a previously started asynchronous research task. When the status is `completed`, the response includes the answer and citations. When the status is `failed`, the response includes an error message.

## Path parameters

- `task_id` string, required

## Response `200`

Research task status.

- object
  - `data` ResearchTaskStatus
    - `task_id` string, required: The research task identifier.
    - `status` 'pending' | 'running' | 'completed' | 'failed', required: Current status of the research task.
    - `answer` string: The synthesized research answer (present when status is `completed`).
    - `citations` ResearchCitation[]: Sources cited in the answer (present when status is `completed`).
      - `url` string, uri, required: Source URL.
      - `title` string, required: Title of the source page.
      - `snippet` string: Relevant excerpt from the source (if available).
    - `error` string, nullable: Always present in poll responses; `null` unless the task failed.

## Other responses

- `401`: Unauthorized — missing or invalid API key. The API Gateway returns this response before the request reaches the backend service. The error format follows the standard Telnyx JSON:API error envelope with `errors[]`, not the backend-level `WebSearchError` shape.
- `404`: Research task not found. Returned for unknown, malformed, expired, or already-purged task IDs.
- `500`: Internal server error.
- `502`: The upstream search provider returned an error.

## Changes

- **2026-10-15** `a72569d69430`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/team-telnyx/apis/telnyx-api/changes/web_search/research/:task_id/get.md)

---

[API](https://skmtc.dev/team-telnyx/apis/telnyx-api.md) - [All operations](https://skmtc.dev/team-telnyx/apis/telnyx-api/llms.txt) - [OpenAPI document](https://skmtc.dev/team-telnyx/apis/telnyx-api/revisions/0f17b8167873?raw)