Get upcoming scheduled matches for a cricket team by teamId

View all Cricket Live Scores, Scorecards & Stats API endpoints →

Returns the scheduled matches for one cricket team. The single required path input is teamId, a numeric team identifier taken from the teamId field of the teams list endpoint; the default example value is 2. The request path ends in /schedule. The source response example shows a top-level appIndex object with navigation metadata and a teamMatchesData array. Fixture entries use a matchDetailsMap whose key is a date label such as Tue, 06 Oct 2026, with a match array and a seriesId. Each match has matchInfo (matchId, matchDesc, matchFormat, state such as Preview or Upcoming, status and hideScoreStatus text such as Match starts at Oct 06, 13:30 GMT, isTimeAnnounced, startDate and endDate as millisecond epoch strings, seriesId, seriesName, series start and end dates, team1 and team2 with teamId, teamName, teamSName and imageId, and venueInfo with id, ground, city and timezone). Some array entries are advertisement slots with an adDetail object instead of fixture data. No live probe was recorded, so these fields come from an unverified, possibly truncated source example. The path takes no documented paging or date-range inputs.

API Features

Fixtures grouped by date label In the source example each matchDetailsMap entry is keyed by a date label such as Tue, 06 Oct 2026 and carries a seriesId, so a schedule view can render day-by-day sections.
Start-time fields matchInfo gives startDate and endDate as millisecond epoch strings, an isTimeAnnounced flag and a status line like Match starts at Oct 09, 13:30 GMT for countdown or calendar displays.
Fixture state labels The state field distinguishes entries such as Preview and Upcoming, and matchDesc names the fixture, for example 1st T20I or 4th T20I, within a series.
Opponent and venue per fixture team1 and team2 return teamId, names and short names, while venueInfo adds ground, city, venue id and timezone so each fixture can show where and against whom a team plays.
Series context on every match seriesId, seriesName and the series start and end dates are repeated on each match, which helps you link fixtures to a tour page without a second lookup.

Live API Demo

GET /api/project/cricbuzz-cricket/teams-get-schedules

Request cost is temporarily unavailable. No price is assumed.

View pricing

API Response (JSON)

{}
curl -X GET 'https://api.opendata-api.com/api/project/cricbuzz-cricket/teams-get-schedules?key=<API_KEY>&teamId=2'
📢
Need Help?
If you encounter API issues or need other API requirements, please contact us.
Contact Us

Use Cases

Frequently asked questions

What does the teams-get-schedules endpoint return?

It returns scheduled matches for the team identified by teamId. The source example shows teamMatchesData entries grouped by date label, each with matchInfo describing the fixture, opponents, series and venue.

Why is the path /schedule while the operation name is plural?

The operation is named teams-get-schedules, but the request path ends in /schedule. Call the path exactly as documented with your teamId in place of the placeholder.

Where do I get a valid teamId?

Use the teamId field from the teams list endpoint. The prefilled value 2 is only a default example, and the source example for this operation shows it returning fixtures where the team is named India.

Does it send reminders or push notifications?

No. It only returns fixture data. If you build reminders, validate the returned start times and re-check for changes before notifying anyone.

How should I read the start time of a fixture?

In the source example startDate and endDate are millisecond epoch strings, while status and hideScoreStatus hold a human-readable GMT start line. Check isTimeAnnounced before treating a time as final.

Why do some entries have adDetail instead of fixtures?

The source example interleaves advertisement slot objects with the fixture groups. Skip entries that lack matchDetailsMap when you build a schedule. No live probe was recorded, so confirm this against a real response.

Related operations

Guides

View Subscription Plans →