---
title: "Get report audio"
description: "Returns audio file metadata or redirects to the CDN URL. Requires the `reports:audio` scope. 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/getReportAudio/
---

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

# Get report audio

Returns audio file metadata or redirects to the CDN URL. Requires the \`reports:audio\` scope. 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}/audio`

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

## Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `reportId` | path | string | Yes | Stable Y2 public report ID (`rpt_...`). Legacy IDs are accepted during migration. |
| `redirect` | query | boolean | No | When true, redirects with `302` to the audio CDN URL |

## Responses

| Status | Description | Body |
| --- | --- | --- |
| 200 | Audio metadata | `AudioResponse` |
| 302 | Redirect to audio CDN URL |  |
| 401 | Missing or invalid API key |  |
| 402 | x402 payment required | `X402PaymentRequiredResponse` |
| 403 | Insufficient permissions or access denied |  |
| 404 | Report not found or no audio available |  |

### 200 response fields

| Field | Type | Description |
| --- | --- | --- |
| `data` | `AudioMetadata` |  |
| `data.url` | string (uri) | CDN URL for audio file |
| `data.duration` | number | Duration in seconds |
| `data.durationSeconds` | number or null | Canonical duration in seconds. |
| `data.durationFormatted` | string | Duration as HH:MM:SS |
| `data.format` | `mp3` |  |
| `data.mimeType` | `audio/mpeg` |  |
| `data.fileSizeBytes` | integer or null | File size in bytes. |
