Fixtures API ★ USED

Source: https://www.cricketapi.com/v5/docs/fixtures-rest-api Refresh: Every 3 hours + Post-Match Validation

Overview

A list of all matches including past, present, and future. Access match schedules, venues, participating teams, organizing associations, and match formats.

Endpoints

Default fixtures (MG100)

GET /v5/cricket/{project_key}/fixtures/

Paginated fixtures (MG101)

GET /v5/cricket/{project_key}/fixtures/mg/MG101/date/{YYYY-MM}/page/{page}/

Headers

rs-token: <access_token>

Sample Request (Node.js)

// Default fixtures
const response = await axios.get(
  `https://api.sports.roanuz.com/v5/cricket/${projectKey}/fixtures/`,
  { headers: { 'rs-token': token } }
);

// Paginated by month
const month = '2026-03';
const page = 1;
const response = await axios.get(
  `https://api.sports.roanuz.com/v5/cricket/${projectKey}/fixtures/mg/MG101/date/${month}/page/${page}/`,
  { headers: { 'rs-token': token } }
);

Response Structure

{
  "status_code": 200,
  "data": {
    "months": {
      "2026-03": {
        "matches": {
          "<match_key>": {
            "key": "ipl_2026_t20_01",
            "name": "CSK vs MI, 1st Match",
            "status": "not_started",
            "format": "t20i",
            "start_at": 1711234567,
            "teams": {
              "a": { "key": "csk", "name": "Chennai Super Kings", "short_name": "CSK" },
              "b": { "key": "mi", "name": "Mumbai Indians", "short_name": "MI" }
            },
            "tournament": { "key": "ipl_2026", "name": "IPL 2026" },
            "venue": { "name": "MA Chidambaram Stadium", "city": "Chennai", "country": "India" }
          }
        }
      }
    },
    "cache": { "key": "fixtures", "expires": 10800, "max_age": 3600 }
  }
}

Key Fields

Field	Type	Description
months	Object	Map of YYYY-MM → month data
months[].matches	Object	Map of match_key → match data
Each match	Object	Same structure as Featured Matches (key, name, status, format, teams, venue, etc.)

Hannibal Usage

File: RoanuzDataAdapter.ts → getMatches(), getVenueStatistics()

const fixturesData = await this.makeRequest('/fixtures/');
const fixtureMatches = this.extractAndNormalizeMatches(fixturesData);

The adapter handles two response shapes:

1. data.months → grouped by month, iterate month values then match values
2. data.matches → flat list of matches

Both are normalized to CricketMatch[] canonical model.