---
title: "Get a single event by ID"
method: GET
path: "/v1/events/{event_id}"
tags: ["events"]
---

# Get a single event by ID

`GET /v1/events/{event_id}`

## Request

- Base URL: `http://localhost:8000`
- URL: `http://localhost:8000/v1/events/{event_id}`
- Auth: API key in header `X-Api-Key`

404s if the event doesn't exist, is unpublished, is beyond your tier's archive window, or was soft-deleted — never distinguishes which, to avoid leaking data existence beyond what the tier allows.

## Path parameters

- `event_id` string, required

## Response `200`

Successful Response

- EventResponse
  - `data` Event, required: Full event; paid fields optional (omitted on free via gating, never null-for-tier).
    - `event_id` string, required
    - `schema_version` string, required
    - `taxonomy_version` string, required
    - `primary_category` string, required
    - `subcategory` string, required
    - `categories` string[], required
    - `type_confidence` 0.9 | 0.6 | 0.3, required
    - `headline` string, required
    - `summary` string, required
    - `occurred_at` string, date-time, nullable
    - `reported_at` string, date-time, required
    - `orgs` string[], required
    - `models` string[], required
    - `source_url` string, required
    - `article_count` integer, required
    - `people` string[], nullable
    - `regions` string[], nullable
    - `confirmation_status` 'confirmed' | 'unconfirmed' | 'speculative' | 'unclear'
    - `confirmation_confidence` number, nullable
    - `source_tier` 'PRIMARY' | 'TIER1_PRESS' | 'SECONDARY' | 'SOCIAL'
    - `source_credibility` number, nullable
    - `sentiment` 'positive' | 'negative' | 'neutral' | 'mixed'
    - `impact_score` number, nullable
    - `tags` string[], nullable
    - `related_event_ids` string[], nullable
    - `correction_history` object[], nullable
    - `details` object, nullable
    - `article_cluster` object[], nullable
  - `meta` Meta, required
    - `request_id` string, required
    - `taxonomy_version` string, required
    - `tier` 'free' | 'pro' | 'enterprise', required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/scoopkit/apis/scoopkit-api.md) · [All operations](https://skmtc.dev/scoopkit/apis/scoopkit-api/llms.txt) · [OpenAPI document](https://skmtc.dev/scoopkit/apis/scoopkit-api/revisions/18068781261d?raw)