events

Get multiple events in one call

Fetch multiple events by id in a single round-trip — for agents that already have a list of ids (e.g. from GET /v1/events) and want full detail for each without issuing one GET per event.

Body: {"event_ids": [1, 2, 3], "include_odds": bool, "include_intelligence": bool, "bookmaker": str} Max 25 ids per call. Duplicate ids are billed once. Credits are the sum of each event's normal GET /v1/events/{id} cost — billing fairness applies per event (unavailable odds/intelligence are free; ids that don't exist cost nothing and are returned under "not_found").

post/v1/events/batch

Request

  • Base URL: https://lumify.ai
  • URL: https://lumify.ai/v1/events/batch
  • Auth: HTTP bearer

Request body

event_idsinteger[] required

Event ids to fetch (max 25). Duplicates are billed once.

include_oddsboolean

Inline current odds on each event. Scoped by bookmaker (default: pinnacle). Does not add credits — each found event stays 1 credit.

include_intelligenceboolean

Inline bet intelligence on each event. Does not add credits.

bookmakerstring nullable

Bookmaker for inlined odds and intelligence market prices. Defaults to pinnacle; 'all' or a comma-separated list for multiple books.

Response

Requested events (each shaped like GET /v1/events/{id}) plus any ids not found

not_foundinteger[]

Requested event_ids that don't exist. Never billed.

totalinteger

Changes

No recorded changes to this operation across all 1 revision of this API.