---
title: "List All Research"
method: GET
path: "/v1/research"
tags: ["Research"]
---

# List All Research

`GET /v1/research`

List all research reports/dashboards for an organization.

Optionally filter by type, knowledge base slug, or status.

## Query parameters

- `type` 'report' | 'dashboard', nullable
- `knowledge` string, nullable
- `status` string, nullable
- `limit` integer, nullable
- `offset` integer, nullable

## Headers

- `authorization` string, nullable

## Response `200`

Successful Response

- ResearchListResponse — Schema for listing all research.
  - `research` ResearchReport[], required — List of research items
    - `id` string, required — Report ID
    - `type` string — Artifact type (report or dashboard)
    - `title` string, required — Report title
    - `content` union — Report content - markdown for reports, JSON for dashboards (includes layout)
      - string
      - object
    - `status` string, required — Report status
    - `query` string, required — Research query
    - `created_at` string, required — Creation timestamp
    - `updated_at` string, nullable — Update timestamp
    - `knowledge_slug` string, nullable — Knowledge base slug
    - `organization_slug` string, required — Organization slug
    - `cadence_minutes` integer, nullable — Schedule cadence in minutes
    - `next_execution_at` string, nullable — Next scheduled execution time
    - `last_executed_at` string, nullable — Last scheduled execution time
    - `schedule_status` string, nullable — Schedule status: active, paused, or null
    - `public` boolean, nullable — Whether the research is publicly accessible
  - `total` integer, required — Total count
  - `counts` object, required — Counts by type

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/chonkie/apis/chonkie-api.md) · [All operations](https://skmtc.dev/chonkie/apis/chonkie-api/llms.txt) · [OpenAPI document](https://skmtc.dev/chonkie/apis/chonkie-api/revisions/f40f036f941c?raw)