# deepResearchReport

Query

Return one Deep Research report, with its Markdown once it has completed.

Available to agents as MCP tool `getDeepResearchReport` — see [Read tools](/api/v2/docs/mcp/read-tools#get-deep-research-report).

## Arguments

| Name | Type | Required | Default | Description |
| --- | --- | --- | --- | --- |
| `id` | `ID!` | Yes | — | Report UUID, as returned by `createDeepResearchReport` or `deepResearchReports`. |

## Returns

Returns [`DeepResearchReport`](/api/v2/docs/types/deep-research-report).

## Examples

### Get a Deep Research report by ID

Poll one report until `running` is false; a completed report carries its Markdown and share link.

```graphql
query DeepResearchReportDefault($id: ID!) {
  deepResearchReport(id: $id) {
    id
    status
    running
    title
    templateSlug
    inputType
    sourceId
    sourceName
    createdAt
    completedAt
    postsAnalyzed
    shareUrl
    markdown
  }
}
```

Variables:

```json
{
  "id": "5d0c3f1e-8a42-4b7e-9c61-2f8e4a9b7d13"
}
```

Response — HTTP 200:

```json
{
  "data": {
    "deepResearchReport": {
      "id": "5d0c3f1e-8a42-4b7e-9c61-2f8e4a9b7d13",
      "status": "COMPLETED",
      "running": false,
      "title": "Share of Voice: Northwind Botanicals vs Verdant Co. and Rootbound",
      "templateSlug": "share-of-voice",
      "inputType": "BRAND",
      "sourceId": "28add94e-9994-54b2-9aaa-528e6606efe9",
      "sourceName": "Verdant Co.",
      "createdAt": "2024-12-31T10:00:00Z",
      "completedAt": "2024-12-31T10:06:00Z",
      "postsAnalyzed": 120,
      "shareUrl": "https://deep-research.archive.com/r/5d0c3f1e-8a42-4b7e-9c61-2f8e4a9b7d13",
      "markdown": "# Share of Voice\n\nNorthwind Botanicals held 46% of the conversation in December, ahead of Verdant Co. (31%) and Rootbound (23%).\n"
    }
  }
}
```