---
title: "Get deep research job status and result"
method: GET
path: "/ai/v1/deep-research/{id}"
---

# Get deep research job status and result

`GET /ai/v1/deep-research/{id}`

Returns the current status of a deep research job. When status is 'completed', the response includes the generated report and sources. Poll this endpoint to check progress.

## Response `200`

Default response

- object
  - `created_at` integer, required — Unix timestamp when the job was created
  - `error` object — Error details, populated when status is 'failed'
    - `code` string, required — A machine-readable error code: insufficient_credits, timeout, internal_error, cancelled
    - `message` string, required — A human-readable error message describing the failure
  - `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'
  - `output` object — The research output, populated when status is 'completed'
    - `report` string, required — The generated deep research report in markdown format
    - `sources` DeepResearchSource[] — Sources cited in the report
      - `citationId` integer
      - `domain` string
      - `title` string
      - `url` string
  - `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)