---
title: "List deep research jobs"
method: GET
path: "/ai/v1/deep-research"
---

# List deep research jobs

`GET /ai/v1/deep-research`

Returns a paginated list of deep research jobs for the authenticated user. Optionally filter by status using the 'status' query parameter.

## Query parameters

- `limit` integer, required
- `offset` integer, required
- `status` string, required

## Response `200`

Default response

- object
  - `data` DeepResearchResponse[], required — List of deep research jobs
    - `created_at` integer, required — Unix timestamp when the job was created
    - `job_id` string, byte, required — Unique identifier for the deep research job
    - `model` string, required — Model used for the deep research
    - `object` string, required — Type of object returned, always 'deep_research'
    - `query` string, required — The research query that was submitted for this job
    - `status` string, required — Current status of the deep research job: queued, in_progress, completed, failed, cancelled

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `500` — Internal Server Error

---

[API](https://skmtc.net/messari/apis/messari-api-deep-research-v1.md) · [All operations](https://skmtc.net/messari/apis/messari-api-deep-research-v1/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/messari/messari-api-deep-research-v1/revisions/af35b9757e14/schema)