---
title: "Get research status and results"
method: GET
path: "/search/v1/research/{id}"
tags: ["Search"]
---

# Get research status and results

`GET /search/v1/research/{id}`

Retrieve the status and results of a deep research task by ID. Supports both standard JSON responses and streaming for real-time updates as the research progresses. Research tasks analyze topics comprehensively using web search and AI synthesis.

## Path parameters

- `id` string, required

## Query parameters

- `stream` boolean
- `events` string

## Response `200`

Research status and results

- object
  - `id` string — Research task ID
  - `status` 'pending' | 'running' | 'completed' | 'failed' — Current status of the research task
  - `query` string — Original research query
  - `model` 'fast' | 'normal' | 'pro' — Research model used
  - `results` object — Research findings and analysis
    - `summary` string — Executive summary of research findings
    - `sections` object[] — Detailed research sections
      - `title` string
      - `content` string
      - `sources` object[]
        - `url` string
        - `title` string
        - `snippet` string
    - `sources` object[] — All sources referenced in research
      - `url` string
      - `title` string
      - `snippet` string
  - `progress` number — Completion percentage (0-100)
  - `createdAt` string, date-time — Task creation timestamp
  - `completedAt` string, date-time — Task completion timestamp

## Other responses

- `400` — Invalid research ID or parameters
- `401` — Invalid API key
- `403` — Insufficient permissions for Search service
- `404` — Research task not found

---

[API](https://skmtc.net/casemark/apis/case-dev-api.md) · [All operations](https://skmtc.net/casemark/apis/case-dev-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/casemark/case-dev-api/revisions/5b7e64e6d6f9/schema)