Documentation / Subjects
Line-ups, sports data API
Line-upsWho started, who was on the bench, the formation and every change.
Ask for a match's line-ups by its id. Football gives both formations, the starting elevens, the substitutes and each substitution with its minute. Rugby gives both sides' fifteens and benches, basketball the box score, and volleyball the line-up set by set. Every player has an id that opens the player.
When they arrive
Line-ups are there once announced, usually shortly before the start, and stay with the match for good.
Racing
For racing, the runners are the line-up: /v1/horses/races/{id} gives every runner with its draw, and greyhounds every trap.
Try it
Football: Line-ups, with your key.
200 OK1289 ms1 recordReal answer from 2026-11-03, trimmed
{
"data": {
"match_id": "fb_p04h38sesj",
"home_team_name": "Kataller Toyama",
"away_team_name": "Vegalta Sendai",
"kickoff_utc": "2026-11-03T04:55:00Z",
"home_formation": null,
"away_formation": null,
"lineups": null,
"substitutions": null,
"appearances": null
},
"meta": {
"sport": "football",
"endpoint": "/events/{id}/lineups",
"as_of": "2026-11-02T05:16:53Z",
"cached": false,
"age_seconds": 0
}
}No key yet? Get a free key: it reads yesterday for every sport and is filled in here once made.
The endpoints
Every sport that answers it.
GET /v1/football/events/{id}/lineupsFootball: Starters, substitutes and formations for both sidesOpen page ›GET /v1/basketball/events/{id}/lineupsBasketball: Starters, substitutes and formations for both sidesOpen page ›GET /v1/rugby/events/{id}/lineupsRugby: Starters, substitutes and formations for both sidesOpen page ›GET /v1/volleyball/events/{id}/lineupsVolleyball: Starters, substitutes and formations for both sidesOpen page ›GET /v1/football/events/{id}Football: One match in full: both sides, the score, the venue and the officialsOpen page ›GET /v1/basketball/events/{id}Basketball: One game in full: both sides, the score, the venue and the officialsOpen page ›GET /v1/rugby/events/{id}Rugby: One match in full: both sides, the score, the venue and the officialsOpen page ›GET /v1/volleyball/events/{id}Volleyball: One match in full: both sides, the score, the venue and the officialsOpen page ›GET /v1/football/players/{id}Football: A player and their figuresOpen page ›GET /v1/cricket/players/{id}Cricket: A player's career by formatOpen page ›GET /v1/basketball/players/{id}Basketball: A player and their figuresOpen page ›GET /v1/rugby/players/{id}Rugby: A player and their figuresOpen page ›GET /v1/darts/players/{id}Darts: A player and their recordOpen page ›GET /v1/volleyball/players/{id}Volleyball: A player and their figuresOpen page ›GET /v1/table-tennis/players/{id}Table tennis: A player and their recordOpen page ›GET /v1/badminton/players/{id}Badminton: A player and their recordOpen page ›