---
title: "Get a report"
description: "Returns a compact report by default. Use bounded `include` values or `view=agent`. Request `text/markdown` for the canonical Markdown representation. Accepts a bearer API key or [x402 payment](https://y2.dev/docs/api/x402). Without a key, read the `402` challenge in `PAYMENT-REQUIRED`. Retry with `PAYMENT-SIGNATURE`."
canonical: https://y2.dev/docs/api/reference/reports/getReport/
---

Endpoint Reference[Reports](https://y2.dev/docs/api/reference/reports)

# Get a report

Returns a compact report by default. Use bounded \`include\` values or \`view=agent\`. Request \`text/markdown\` for the canonical Markdown representation. Accepts a bearer API key or \[x402 payment]\(https\://y2.dev/docs/api/x402). Without a key, read the \`402\` challenge in \`PAYMENT-REQUIRED\`. Retry with \`PAYMENT-SIGNATURE\`.

`GET https://api.y2.dev/api/v1/reports/{reportId}`

- Operation ID: `getReport`
- Required scopes: `reports:read`
- Accepts x402 pay-per-request payment
- Contract: https://y2.dev/openapi.json

## Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `include` | query | string | No | Comma-separated `content,sources,signals,graph,audio` expansions. |
| `view` | query | `agent` | No | Compact projection optimized for grounded agent context. |
| `format` | query | `markdown` | No | Explicit representation override. |
| `reportId` | path | string | Yes | Stable Y2 public report ID (`rpt_...`). Legacy IDs are accepted during migration. |

## Responses

| Status | Description | Body |
| --- | --- | --- |
| 200 | Report details | `ReportDetailResponse` |
| 400 | Invalid request parameters |  |
| 401 | Missing or invalid API key |  |
| 402 | x402 payment required | `X402PaymentRequiredResponse` |
| 403 | Insufficient permissions or access denied |  |
| 404 | Resource not found |  |
| 429 | Rate limit exceeded (per-key or per-account aggregate) |  |
| 500 | Internal server error |  |

### 200 response fields

| Field | Type | Description |
| --- | --- | --- |
| `data` | `PublicReportDetail` |  |
| `data.source` | `RecordSource` | Where a record came from, how Y2 obtained it, and when. |
| `data.id` | string |  |
| `data.type` | string |  |
| `data.profileId` | string |  |
| `data.topic` | string or null |  |
| `data.summary` | string or null |  |
| `data.status` | string |  |
| `data.generatedAt` | string (date-time) |  |
| `data.publishedAt` | string (date-time) |  |
| `data.language` | string |  |
| `data.intelligence` | `PublicReportIntelligenceSummary` |  |
| `data.audio` | `PublicReportAudioSummary` |  |
| `data.links` | `PublicResourceLinks` |  |
| `data.profile` | object |  |
| `data.content` | object |  |
| `data.sources[]` | array of `PublicSource` |  |
| `data.signals[]` | array of `PublicReportSignal` |  |
| `data.graph` | `PublicReportGraph` |  |
| `data.audioRepresentation` | `AudioMetadata` |  |
