Match IDs are consistent across all endpoints
Match IDs use theas_ prefix consistently across every endpoint. The same match uses the same match_id across the fixtures list, match details, lineups, live score, match events, live odds, and pre-match odds — and this is identical between the HTTP endpoints and WebSocket pushes.
This means a typical integration flow can be very simple:
1
Query fixtures to get the match_id
Call
/matches (filtered by date, league, or team) to get the match_id of the target match from the results.2
Use the same match_id directly to fetch live data
Pass the
match_id obtained above as-is to /livescore, /matches/{match_id}/situation, and /odds/live — no conversion needed.3
Or subscribe to WebSocket pushes
The same
match_id can also be placed directly into the data.match_id field of a WebSocket subscription request, enabling targeted push updates for a single match.matches, livescore, situation, and odds/live all use as_3b37c382f39a4235aa93705f053b2da4.