---
title: "Get an event"
method: GET
path: "/v1/events/{event_id}"
tags: ["events"]
---

# Get an event

`GET /v1/events/{event_id}`

## Request

- Base URL: `https://lumify.ai`
- URL: `https://lumify.ai/v1/events/{event_id}`
- Auth: HTTP bearer

## Path parameters

- `event_id` integer, required: Lumify event ID

## Query parameters

- `include_odds` boolean: Inline current odds into the response under the 'odds' key. Scoped by bookmaker (default: pinnacle). Does not add credits — the event call stays 1 credit.
- `include_intelligence` boolean: Inline bet intelligence (signals, bets, narratives) into the response under the 'intelligence' key. Does not add credits — the event call stays 1 credit.
- `bookmaker` string, nullable: Bookmaker filter for inlined odds (when include_odds=true) and for intelligence.bets[].market prices (when include_intelligence=true). Valid values: pinnacle, fanduel, draftkings, betmgm, caesars, bet365, circa, westgate, wynn, south_point, stations, hardrock, betonline, betr, betrivers, lowvig, bovada, all. Defaults to pinnacle.
- `include_alts` boolean: When include_odds=true, include alternate spread/total rungs (is_main=false). Default is mains only.

## Response `200`

Full event with participants, venue, and schedule metadata

- EventDetail
  - `id` integer, required
  - `name` string, nullable
  - `sport` string, nullable
  - `league` string, nullable
  - `season_id` integer, nullable
  - `starts_at` string, nullable: ISO-8601 UTC start time.
  - `inprogress_since` string, nullable: ISO-8601 UTC timestamp of the first ingest that marked this event inprogress (first live tick). Null until then; stays set after final. Walkovers and events that never went live are usually null. Not the same as starts_at, which can be a session floor (especially tennis).
  - `status` string, nullable
  - `period` string, nullable
  - `clock` string, nullable
  - `venue` object, nullable
  - `participants` Participant[]
    - `participant_id` integer, nullable
    - `role` string, nullable
    - `team` object, nullable
    - `player` object, nullable
    - `score` string, nullable
    - `is_winner` boolean, nullable
  - `updated_at` string, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/lumify/apis/lumify-sports-intelligence-api.md) · [All operations](https://skmtc.dev/lumify/apis/lumify-sports-intelligence-api/llms.txt) · [OpenAPI document](https://skmtc.dev/lumify/apis/lumify-sports-intelligence-api/revisions/f91ea41a2606?raw)