/api/v1/events/{eventId}/oddsAuth: RequiredRead grouped odds for one event across markets and bookmakers.
Query / path parameters
eventIdrequired- Numeric event id returned by /api/v1/events. Non-numeric ids return 400 validation_failed.
bookmaker- Optional comma-separated bookmaker slug filter. Blank or duplicate entries return 400 validation_failed.
transport- Product channel: rest (default) or live. Live requires plan entitlement; otherwise returns 403 live_not_enabled.
Request
curl "https://api.betspread.io/api/v1/events/12345/odds?bookmaker=tipico&transport=rest" \
-H "Authorization: Bearer $BETSPREAD_API_KEY"Response
{
"data": {
"event": {
"id": "12345",
"sport": "football",
"leagueKey": "bundesliga",
"leagueName": "Bundesliga",
"homeTeam": "Borussia Dortmund",
"awayTeam": "Bayern Munich",
"kickoffAt": "2026-05-09T16:30:00.000Z",
"marketCount": 1
},
"markets": [
{
"type": "match_result_1x2",
"line": null,
"bookmakers": [
{
"slug": "tipico",
"displayName": "Tipico",
"outcomes": [
{
"outcome": "home",
"transport": "rest",
"odds": 2.42,
"status": "open",
"lastUpdatedAt": "2026-05-04T12:10:14.000Z"
}
]
}
]
}
]
}
}