---
title: "Create a deep research job"
method: POST
path: "/ai/v1/deep-research"
---

# Create a deep research job

`POST /ai/v1/deep-research`

Starts a new deep research report generation. The job runs asynchronously and typically takes 5-10 minutes to complete. Use the returned job ID to poll for status and results via GET /v1/deep-research/:id. Consumes 500 credits. Enterprise teams receive 10 free report generations per month (shared with the Messari platform) which are consumed before credits. Optionally provide a job_id to send a follow-up message for iterative refinement of an existing report.

## Response `200`

Default response

- object
  - `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)