Growing Discord community — direct access to the developer, live coverage & picks. Join the Discord Join now →

Lineups: 'confirmed' signal with timestamp, and lineup changes in /fixtures/changes/

Feature Request Football In Progress Nov 09, 2026 · Giove · 🥵 444 aura
Context: about 75 minutes before kickoff I read /api/v2/events/{id}/lineups/ for every match I analyse. The endpoint returns either the confirmed XI or a predicted one, and at that moment some matches have their official lineup and some don't yet. To use it I need to know reliably which one I got, and when it changed. Request: 1. On /lineups/: an explicit `status` field (`predicted` | `confirmed`) per team, plus `confirmed_at` (UTC, when the official XI was first seen) and `source` if you have it. If this exists already under another name, a line in the docs would be enough. 2. On /api/v2/fixtures/changes/: a new change type `lineups` emitted when a team's lineup goes from predicted to confirmed (and if a confirmed XI is later corrected), with event_id, team side and timestamp. Filterable like the others: `?change=lineups&since=...`. 3. Optional, on the live WebSocket: the same event as a frame, so a client can react within seconds. Why it matters: the confirmed XI is the most important piece of pre-match news (a rested striker or a rotated keeper moves the price), and it usually lands 60-75 minutes before kickoff, right when people analyse. With a change feed, clients stop polling every lineup endpoint every few minutes, which also saves you a lot of requests on busy evenings. Thanks!

Comments

2
Nora · BSD Support (AI) · Admin · AI Nov 09, 2026 23:11
Hi Giove, Part of this already exists. /api/v2/events/{id}/lineups/ returns a lineup_status field with the values confirmed, predicted or unavailable, so you can tell which one you got. We start looking for the official teamsheet 75 minutes before kickoff, and once it is published the status flips to confirmed. It is described in the lineups section of the football events docs. What doesn't exist today is a confirmed_at timestamp, a lineups change type in /fixtures/changes/, or a WebSocket frame for it. Those are new features, so I've passed them to Marco, who owns the football product. I can't promise them or give a date; you'll hear back here. In the meantime, polling lineups only for matches inside the last 75 minutes before kickoff keeps your request count low. Nora · BSD Support (AI)
Nora · BSD Support (AI) · Admin · AI Nov 11, 2026 06:34
Hi Giove, Update from Marco: a confirmed_at timestamp on lineups and a lineups change type in /api/v2/fixtures/changes/ are accepted as work. The WebSocket frame is not decided yet, so please don't count on it. Both are queued behind performance fixes, with no date. I'll write here when something ships. Meanwhile lineup_status on /lineups/ already tells you predicted or confirmed. Nora · BSD Support (AI)
Log in to comment.