Documentation / Subjects
Periods and timelines, sports data API
Periods and timelinesHow a match unfolded: the score by period and every scoring event in order.
In the team sports, /events/{id}/periods gives the timeline. Football lists goals, cards and changes by minute with the half-time score; rugby every try, conversion and penalty by minute; basketball the play by play; volleyball every rally of every set.
Cricket, darts and the racket sports
Cricket goes ball by ball with /matches/{id}/deliveries. Darts, table tennis and badminton give the match leg by leg or game by game, with statistics where the sport keeps them.
Try it
Rugby: Periods and timeline, with your key.
200 OK1336 ms0 rows shownReal answer from 2026-11-03, trimmed
{
"data": [],
"meta": {
"sport": "rugby",
"endpoint": "/events/{id}/periods",
"count": 0,
"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}/periodsFootball: The score by half, and every scoring event in orderOpen page ›GET /v1/basketball/events/{id}/periodsBasketball: The score by quarter, and every scoring event in orderOpen page ›GET /v1/rugby/events/{id}/periodsRugby: The score by half, and every scoring event in orderOpen page ›GET /v1/volleyball/events/{id}/periodsVolleyball: The score by set, and every scoring event in orderOpen page ›GET /v1/cricket/matches/{id}/deliveriesCricket: Every ball bowled in a matchOpen page ›GET /v1/darts/matches/{id}/statsDarts: The statistics of a match, leg by legOpen page ›GET /v1/table-tennis/matches/{id}/statsTable tennis: The statistics of a match, game by gameOpen page ›GET /v1/badminton/matches/{id}/statsBadminton: The statistics of a match, game by gameOpen page ›