---
title: "List threat events"
description: "Lists Situation Room threat events. Supports category and severity filters. 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/osint/listOsintEvents/
---

Endpoint Reference[OSINT](https://y2.dev/docs/api/reference/osint)

# List threat events

Lists Situation Room threat events. Supports category and severity filters. 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/osint/events`

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

## Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `temporality` | query | `EventTemporality` | No | `current` (default) returns events that have occurred or are under way, newest first; event times more than 15 minutes after the request are excluded. `forecast` returns scheduled, forecast, and speculative events dated after that point, soonest first. |
| `cursor` | query | string | No | Opaque continuation token from the previous response. Bound to the original filters and ordering. |
| `format` | query | `json`, `ndjson`, `geojson` | No | Select the JSON resource envelope, row-oriented NDJSON, or an RFC 7946 FeatureCollection. |
| `category` | query | `OsintEventCategoryEnum` | No | Filter by event category |
| `severity` | query | `OsintSeverityEnum` | No | Filter by severity level |
| `limit` | query | integer | No | Maximum number of events to return |

## Responses

| Status | Description | Body |
| --- | --- | --- |
| 200 | List of OSINT threat events | `OsintEventListResponse` |
| 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 `OsintEvent` |  |
| `data[].observedAt` | string or null (date-time) | When Y2 retrieved or last refreshed this observation, independent of event time. |
| `data[].temporality` | `EventTemporality` | Whether the event time is at or before the request time (plus 15 minutes of clock skew) — `current` — or after it — `forecast`. |
| `data[].confidence` | number or null | Extraction confidence for report-derived rows; null for directly ingested rows. |
| `data[].provenanceTier` | `primary`, `derived`, `synthesized`, `null` |  |
| `data[].source` | `RecordSource` | Where a record came from, how Y2 obtained it, and when. |
| `data[].id` | string | Event ID |
| `data[].sourceType` | string | Data source type |
| `data[].sourceId` | string | Source-specific event identifier |
| `data[].title` | string | Event title/headline |
| `data[].description` | string | Detailed event description |
| `data[].category` | `OsintEventCategoryEnum` | OSINT event category classification |
| `data[].severity` | `OsintSeverityEnum` | Event severity level |
| `data[].coordinates` | object or null | Geographic coordinates (null if unavailable) |
| `data[].locationName` | string | Human-readable location name |
| `data[].region` | `OsintRegionEnum` | Geographic region identifier |
| `data[].countryCode` | string | ISO alpha-2 country code |
| `data[].eventTime` | integer (int64) | Event time as Unix timestamp (milliseconds) |
| `data[].eventTimeISO` | string (date-time) | Event time as ISO 8601 string |
| `data[].fetchedAt` | integer or null (int64) | Data fetch time as Unix timestamp (milliseconds), null if unavailable |
| `data[].fetchedAtISO` | string or null (date-time) | Data fetch time as ISO 8601 string, null if unavailable |
| `data[].url` | string (uri) | Source URL for the event |
| `data[].provenance` | `Y2EventProvenance` or null | Extraction provenance metadata. Populated only when `sourceType === "y2_report"`. Null for all other sources. Returned by `/osint/regional`. |
| `meta` | object |  |
| `meta.page` | `PublicPageMeta` |  |
| `meta.count` | integer |  |
| `meta.limit` | integer |  |
| `meta.hasMore` | boolean | Whether more results are available beyond the current limit |
| `meta.filters` | object |  |
