---
title: "List intel incidents"
description: "Lists deduplicated, scored ontology incidents linked from the OSINT cache. Filters by category, severity, status, or last-observed lower bound. Required scopes vary by `category` filter: - `category=cyber` → `intel:cyber` or `intel:explorer` - any other category → `intel:finint` or `intel:explorer` - no `category` filter → `intel:explorer` Supports x402 pay-per-request. Requests without `Authorization` return `402 Payment Required` with payment requirements. Retry with a signed `PAYMENT-SIGNATURE` header."
canonical: https://y2.dev/docs/api/reference/intel/listIncidentsV2/
---

Endpoint Reference[Intel](https://y2.dev/docs/api/reference/intel)

# List intel incidents

Lists deduplicated, scored ontology incidents linked from the OSINT cache. Filters by category, severity, status, or last-observed lower bound. Required scopes vary by \`category\` filter: - \`category=cyber\` → \`intel:cyber\` or \`intel:explorer\` - any other category → \`intel:finint\` or \`intel:explorer\` - no \`category\` filter → \`intel:explorer\` Supports x402 pay-per-request. Requests without \`Authorization\` return \`402 Payment Required\` with payment requirements. Retry with a signed \`PAYMENT-SIGNATURE\` header.

`GET https://api.y2.dev/api/v2/incidents`

- Operation ID: `listIncidentsV2`
- Required scopes: `intel:explorer`, `intel:finint`, `intel:cyber`
- Accepts x402 pay-per-request payment
- Contract: https://y2.dev/openapi.json

## Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `cursor` | query | string | No | Opaque continuation token from the previous response. Bound to the original filters and ordering. |
| `fields[incidents]` | query | string | No | Comma-separated allowlist of incident fields. Identity and links remain present. |
| `category` | query | `seismic`, `conflict`, `political`, `economic`, `weather`, `health`, `cyber`, `maritime`, `fire`, `aviation`, `other` | No | Filter incidents by category |
| `severity` | query | `low`, `medium`, `high`, `critical` | No | Filter by severity |
| `status` | query | `active`, `resolved`, `forecast` | No | Filter by lifecycle status |
| `sinceMs` | query | integer (int64) | No | Lower bound on `lastObservedAt` as Unix milliseconds. Useful for polling: pass the largest `lastObservedAt` you've seen. |
| `limit` | query | integer | No | Maximum number of incidents to return |

## Responses

| Status | Description | Body |
| --- | --- | --- |
| 200 | List of intel incidents | `IncidentListResponse` |
| 400 | Invalid request parameters |  |
| 401 | Missing or invalid API key |  |
| 402 | x402 payment required | `X402PaymentRequiredResponse` |
| 403 | Insufficient permissions or access denied |  |
| 429 | Rate limit exceeded (per-key or per-account aggregate) |  |
| 500 | Internal server error |  |

### 200 response fields

| Field | Type | Description |
| --- | --- | --- |
| `data[]` | array of `PublicIncident` |  |
| `data[].source` | `RecordSource` | Where a record came from, how Y2 obtained it, and when. |
| `data[].id` | string |  |
| `data[].type` | string |  |
| `data[].title` | string |  |
| `data[].category` | string |  |
| `data[].severity` | `low`, `medium`, `high`, `critical` |  |
| `data[].status` | `active`, `resolved`, `forecast` |  |
| `data[].occurredAt` | string (date-time) |  |
| `data[].endedAt` | string or null (date-time) |  |
| `data[].firstObservedAt` | string (date-time) | Earliest time Y2 observed the incident, independent of when it occurred. |
| `data[].lastObservedAt` | string (date-time) | Latest time Y2 observed or refreshed the incident, independent of when it occurred. |
| `data[].resolutionReason` | string or null |  |
| `data[].quality` | `PublicIncidentQuality` |  |
| `data[].links` | `PublicResourceLinks` |  |
| `meta` | `PublicListMeta` |  |
| `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` |  |
| `links` | `PublicCollectionLinks` |  |
| `links.self` | string |  |
| `links.next` | string or null |  |
