# Get an event

Source: https://langbot.ai/docs/api/live-events/get-event

`GET /v1/events/{event_id}`

One event with its markets and rules, its sources, and its latest phrase hits.

**Auth.** None. Without a token the call is served as Free (the Free delay and request budget, shared per IP); send `Authorization: Bearer lb_…` for your plan's.

**Limits.** Counts against your plan's API requests (60, 600 or 3,000 a minute on Free, Builder and Standard). Served at your plan's delay (+60 s Free, +10 s Builder, +2 s Standard).

## Parameters

### Path parameters

| Name | Type | Required | Description |
|---|---|---|---|
| `event_id` | string | yes | The event id (`ev_…`). |

## Request

**curl**

```bash
curl "https://api.langbot.ai/v1/events/ev_kxtrumpsaycountry_26dec01"
```

**Python**

```python
from langbot import LangbotClient

async with LangbotClient() as lb:
    e = await lb.event("ev_kxtrumpsaycountry_26dec01")
    print(e.title, e.status, len(e.markets))
```

**TypeScript**

```ts
import { LangbotClient } from "@langbotai/sdk";

const lb = new LangbotClient();
const e = await lb.event("ev_kxtrumpsaycountry_26dec01");
console.log(e.title, e.status);
```

## Response

`200 OK`

```json
{
  "id": "ev_kxtrumpsaycountry_26dec01",
  "title": "What countries will Trump say in November?",
  "kind": "other",
  "starts_at": 1793505600000,
  "ends_at": 1796137200000,
  "status": "scheduled",
  "meta": {
    "venue": "kalshi",
    "window": true,
    "company": null,
    "speaker": "Donald Trump",
    "category": "Mentions",
    "sub_title": "Before Dec 1, 2026",
    "date_known": true,
    "time_known": false,
    "speaker_key": "trump",
    "timing_note": "window market",
    "event_ticker": "KXTRUMPSAYCOUNTRY-26DEC01",
    "market_count": 42,
    "series_title": "Will Trump mention country",
    "series_ticker": "KXTRUMPSAYCOUNTRY",
    "settlement_sources": ["ABC"]
  },
  "speaker_keys": [],
  "sources": [
    {
      "id": "src_kxtrumpsaycountry_26dec01_cspan_youtube_live",
      "event_id": "ev_kxtrumpsaycountry_26dec01",
      "kind": "hls",
      "expected_latency_ms": 20000,
      "status": "planned",
      "rights": "restricted",
      "retention_days": 30
    }
  ],
  "markets": [
    {
      "ticker": "KXTRUMPSAYCOUNTRY-26DEC01-CAN",
      "venue": "kalshi",
      "event_id": "ev_kxtrumpsaycountry_26dec01",
      "title": "Will Trump say \"Canada / Canadian\" before Dec 1, 2026?",
      "rules_text": "If Canada / Canadian, or a plural or possessive form of Canada / Canadian, is stated by Donald Trump before Dec 1, 2026 at 12:00am ET, then the market resolv…",
      "phrases": ["canada"],
      "status": "settled",
      "close_ts": 1793623539000
    }
  ],
  "phrases": ["afghan"],
  "rights": "restricted",
  "stats": {
    "phrases_detected": 1842,
    "events_total": 1905,
    "last_seq": 37878,
    "last_t_spoken": 1793685708503,
    "p50_lag_ms": null
  },
  "delay_ms": 60000,
  "recent_phrases": [
    {
      "id": "evt_GQMRV000WZRRMVQ11Q4WAZY61N",
      "type": "phrase_detected",
      "source_id": "src_shared_aljazeera_english_live",
      "event_id": "ev_kxtrumpsaycountry_26dec01",
      "market_refs": ["KXTRUMPSAYCOUNTRY-26DEC01-PALE"],
      "phrase": "palestinians",
      "raw": "palestinians",
      "speaker": null,
      "confidence": 0.36,
      "t_spoken": 1793685708503,
      "t_detected": 1793685708556,
      "t_emitted": 1793685708575,
      "lag_vs_public_ms": null,
      "source_kind": "hls",
      "seq": 26978,
      "hash": "cb9c34bccf455925870749a7600c9ce2b2feddb015f87d25ab0dbe8f8f9e0f4c",
      "prev_hash": "2aef236c485bf28b9bf7df68d204fdf27ba42f8df4191cab3acd5a221ae99d11",
      "raw_hash": "609ef9b39f1691dbc69419a9aaebf621aa4a3f9955fa3956939bffcaa4ec8cb5",
      "chain_seq": 30595,
      "fact": null,
      "class": "fact",
      "verdict": {
        "role": null,
        "counts": null,
        "needed": 1,
        "reason": "speaker not verified: only Donald Trump counts",
        "mention": 0
      }
    }
  ]
}
```

A real response from the API; long lists are cut to their first items.

## Errors

| Status | `code` | When |
|---|---|---|
| 404 | `not_found` | No event with that id. |
| 401 | `token_invalid` | A token was sent and not recognised. Send a valid one, or none to call anonymously. |
| 422 | `validation_error` | A parameter failed validation; `detail[].loc` names it. |
| 429 | `rate_limited` | Over your request budget; wait `Retry-After` seconds. |

Every error body is `{"detail": …, "code": "…"}`; branch on `code`. All codes: [Errors](https://langbot.ai/docs/api#errors).