---
title: "/research/:id"
method: GET
path: "/v1/research/{id}"
tags: ["Research"]
---

# /research/:id

`GET /v1/research/{id}`

The `GET /research/:id` method, with research task identifier, retrieves a specific research task information.

## Path parameters

- `id` string, required

## Response `200`

Research task details.

- ResearchTaskOutput
  - `createdAt` string, date-time, required — The date and time when the task was created.
  - `error` string, nullable, required — The error message if the task failed.
  - `id` string, required — The unique identifier of the task.
  - `status` 'completed' | 'failed' | 'pending' | 'processing', required — The current status of the task.
  - `updatedAt` string, date-time, required — The date and time when the task status was last updated.
  - `input` ResearchTaskInput, required
    - `excludeDomains` string[] — The domains you want to exclude of the search. By default, don't restrict the search.
    - `fromDate` string, nullable — The date from which the search results should be considered, in ISO 8601 format (YYYY-MM-DD). It must be before `toDate`, if provided, and later than 1970-01-01.
    - `includeDomains` string[] — The domains you want to search on. By default, don't restrict the search. You can provide up to 100 domains.
    - `q` string, required — The natural language question for which you want to retrieve context.
    - `structuredOutputSchema` unknown
    - `toDate` string, nullable — The date until which the search results should be considered, in ISO 8601 format (YYYY-MM-DD). It must be later than `fromDate`, if provided, or than 1970-01-01.
    - `mode` 'answer' | 'auto' | 'investigate' | 'research' — Pin the research agent mode. Omit to let the agent auto-classify per request based on the question.
    - `outputType` 'sourcedAnswer' | 'structured', required — The type of output you want to get. Use `structured` for a custom-formatted response defined by `structuredOutputSchema`.
    - `reasoningDepth` 'L' | 'M' | 'S' | 'XL' — Pin the reasoning depth (S < M < L < XL). Defaults to L when omitted. Higher depths trade latency for thoroughness.
  - `output` union, required
    - ResearchSourcedAnswerOutput
      - `answer` string, required — The answer to your question.
      - `sources` Source[], required — List of sources used to answer the question.
        - `name` string, required — The title or name of the resource.
        - `url` string, uri, required — The URL of the resource.
        - `favicon` union, required — The favicon URL, if available.
          - '', uri
          - string, uri
        - `snippet` string, required — Extracted text content associated with the source.
    - StructuredOutput
  - `type` 'research', required

## Other responses

- `400` — Bad Request - Invalid parameters
- `401` — Unauthorized - Invalid or missing API key

---

[API](https://skmtc.net/linkup/apis/linkup-api.md) · [All operations](https://skmtc.net/linkup/apis/linkup-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/linkup/linkup-api/versions/1e5050ee899a/schema)