---
title: "List AI-generated recaps"
description: "Lists AI-generated recaps for selected topics and timeframe. 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/news/listRecaps/
---

Endpoint Reference[News](https://y2.dev/docs/api/reference/news)

# List AI-generated recaps

Lists AI-generated recaps for selected topics and timeframe. 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/news/recaps`

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

## Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `topics` | query | string | No | Comma-separated list of topics. Use `GET /news/feeds` to discover the current topic catalog. |
| `timeframe` | query | `TimeframeEnum` | No | Time period for recaps |

## Responses

| Status | Description | Body |
| --- | --- | --- |
| 200 | Topic recaps | `RecapResponse` |
| 400 | Invalid request parameters |  |
| 401 | Missing or invalid API key |  |
| 402 | x402 payment required | `X402PaymentRequiredResponse` |

### 200 response fields

| Field | Type | Description |
| --- | --- | --- |
| `data` | object |  |
| `meta` | object |  |
| `meta.timeframe` | `TimeframeEnum` | Time period for recap data |
| `meta.topics[]` | array of `TopicEnum` |  |
