# deepResearchReports

Query

List the Deep Research reports in the current workspace, newest first.

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

## Arguments

| Name | Type | Required | Default | Description |
| --- | --- | --- | --- | --- |
| `after` | `String` | No | — | The `endCursor` of the previous page. |
| `filter` | [`DeepResearchReportFilterInput`](/api/v2/docs/types/deep-research-report-filter-input) | No | — | Narrow the list. |
| `first` | `Int` | No | `20` | Page size, 1 to 100. Keep it the same while paging with `after`. |

## Returns

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

## Examples

### List Deep Research reports

Page through the workspace's Deep Research reports, newest first, whoever started them.

```graphql
query DeepResearchReportsDefault($first: Int) {
  deepResearchReports(first: $first) {
    nodes {
      id
      status
      running
      title
      templateSlug
      inputType
      sourceName
      createdAt
      completedAt
      shareUrl
    }
    pageInfo {
      hasNextPage
      endCursor
    }
    totalCount
  }
}
```

Variables:

```json
{
  "first": 10
}
```

Response — HTTP 200:

```json
{
  "data": {
    "deepResearchReports": {
      "nodes": [
        {
          "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",
          "sourceName": "Verdant Co.",
          "createdAt": "2024-12-31T10:00:00Z",
          "completedAt": "2024-12-31T10:06:00Z",
          "shareUrl": "https://deep-research.archive.com/r/5d0c3f1e-8a42-4b7e-9c61-2f8e4a9b7d13"
        }
      ],
      "pageInfo": {
        "hasNextPage": false,
        "endCursor": null
      },
      "totalCount": 1
    }
  }
}
```