CricketLineAPI

Cricket schedule API for upcoming fixtures

Build calendars, reminders, and match hubs from upcoming international and major domestic fixtures. Every fixture includes the teams, format, start time, venue, and series context.

Fixture fields

Teams and format

Each fixture identifies both teams and whether it is Test, ODI, T20, or a league match.

Date and status

Start time and match status support calendars and reminder jobs.

Venue

Ground, city, and country help users filter matches by location.

Series link

Each match can be connected to its tournament or bilateral series.

Example fixture

{"match_id":"ind-eng-t20-2026-01","title":"India vs England","format":"T20I","date":"2026-10-01T14:00:00Z","venue":"Eden Gardens","series":"India vs England T20I Series","status":"upcoming"}

Schedule use cases

Match calendars

Show upcoming fixtures grouped by date or competition.

Alerts

Notify users before a selected team plays.

Broadcast hubs

List today's matches and link each one to live data.

Fantasy planning

Find upcoming matches before player stats are requested.

Schedule endpoints

GET /api/schedule

Returns the default upcoming fixture window.

GET /api/schedule?format=t20

Filters fixtures by cricket format.

GET /api/schedule?team=india

Filters fixtures for a team.

GET /api/series/{id}/schedule

Returns fixtures that belong to one series.

Implementation notes

Store the match ID from the schedule response. The same ID is used by the live, scorecard, commentary, and fantasy endpoints, so the schedule should be the entry point for a match page. Filter by team or format before rendering a large list.

Treat start times as UTC and convert them in the client. Match status can change from upcoming to live and then to completed, so a calendar should refresh the current day more often than future dates. Venue names should be displayed as returned rather than reconstructed from the city.

The schedule endpoint answers what will be played. It does not replace the scorecard or commentary endpoints. Once a fixture becomes live, link the user to the live match page and start requesting match data with its match ID.

Schedule questions

How far ahead can I query?

The default response covers upcoming fixtures and can be narrowed by date, team, or format.

Are domestic leagues included?

Major domestic competitions are included alongside international fixtures.

Do official changes appear?

New fixtures and official changes appear after the source schedule is updated.

Related cricket APIs

Start with the free cricket data tier

Create an API key, call the endpoint with a match, player, or series ID, and upgrade only when your traffic grows.

Compare API plans