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

# Get public betting splits for an event

`GET /v1/events/{event_id}/splits`

## Request

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

Public bets% and handle% per side (moneyline, spread, total), with a cross-book consensus and per-bookmaker breakdown. Bookmaker keys match /odds slugs (e.g. draftkings, fanduel) under bookmakers[].bookmaker. Available for MLB, NBA, NHL, NFL, NCAAF, and NCAAB. Not available for tennis or soccer (upstream 400). available:false is free.

## Path parameters

- `event_id` integer, required: Lumify event ID

## Response `200`

Public bets% and handle% per side, per market, per bookmaker. Shape: bookmakers[].bookmaker (odds slug) + consensus averages. Available for MLB, NBA, NHL, NFL, NCAAF, and NCAAB; not for tennis or soccer. If no splits have been ingested for this event (or the sport is unsupported), returns 200 with available=false and is NOT charged (X-Credits-Used: 0).

- SplitsResponse
  - `event_id` integer, required: Lumify event ID.
  - `available` boolean: false when no splits have been ingested (or sport unsupported). available:false is not charged.
  - `captured_at` string, nullable: UTC timestamp of the most recent splits ingest for this event; null when available is false.
  - `consensus` object: Cross-bookmaker averages per market/side (moneyline/spread/total → home/away/over/under → bets_pct, handle_pct, optional price/line).
  - `bookmakers` object[]: Per-bookmaker breakdown. Each item: {bookmaker: odds slug (e.g. draftkings), name, moneyline, spread, total}. Bookmaker keys match /odds (not upstream short keys like dk).

## 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)
