---
title: "List news items"
description: "Lists cached Y2 News Terminal items with topic filters and pagination. 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/listNews/
---

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

# List news items

Lists cached Y2 News Terminal items with topic filters and pagination. 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`

- Operation ID: `listNews`
- 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 to filter by. Use `GET /news/feeds` to discover the current topic catalog. Default: crypto, geopolitics, macro, equities, ai, energy |
| `limit` | query | integer | No | Maximum number of items to return |
| `countryCode` | query | string | No | Filter by canonical ISO 3166-1 alpha-2 country code. When supplied without `topics`, the query searches every News Terminal topic. |
| `cursor` | query | string | No | Opaque continuation token from the previous response. Bound to the original filters and ordering. |
| `format` | query | `json`, `ndjson` | No | Use `ndjson` for row-oriented streaming output. |

## Responses

| Status | Description | Body |
| --- | --- | --- |
| 200 | List of news items | `NewsListResponse` |
| 400 | Invalid topics |  |
| 401 | Missing or invalid API key |  |
| 402 | x402 payment required | `X402PaymentRequiredResponse` |
| 503 | News cache is initializing |  |

### 200 response fields

| Field | Type | Description |
| --- | --- | --- |
| `data[]` | array of `NewsItem` |  |
| `data[].id` | string |  |
| `data[].type` | string |  |
| `data[].title` | string |  |
| `data[].summary` | string |  |
| `data[].content` | string |  |
| `data[].publishedAt` | string (date-time) |  |
| `data[].topics[]` | array of string |  |
| `data[].sentiment` | object |  |
| `data[].sources[]` | array of `NewsSource` |  |
| `data[].author` | string or null |  |
| `data[].links` | object |  |
| `data[].geography` | object or null | Normalized country, region, location, coordinates, and resolver provenance. |
| `meta` | object |  |
| `meta.count` | integer |  |
| `meta.pageCount` | integer |  |
| `meta.limit` | integer |  |
| `meta.isDone` | boolean |  |
| `meta.hasMore` | boolean |  |
| `meta.nextCursor` | string or null |  |
| `meta.asOf` | string (date-time) |  |
| `meta.page` | `PublicPageMeta` |  |
| `meta.topics[]` | array of `TopicEnum` |  |
| `meta.countryCode` | string or null |  |
| `links` | `PublicCollectionLinks` |  |
| `links.self` | string |  |
| `links.next` | string or null |  |
