Skip to main content

Match Scorecard API ★ USED

Source: Roanuz Cricket API (scorecard endpoint)

Overview​

Full scorecard for a match including batting/bowling details per innings.

Endpoint​

GET /v5/cricket/{project_key}/match/{match_key}/scorecard/

Headers​

rs-token: <access_token>

Sample Request (Node.js)​

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

Response Structure​

Returns full scorecard data with innings-level batting and bowling performances.

Hannibal Usage​

File: RoanuzDataAdapter.ts → getScorecard()

async getScorecard(matchId: string): Promise<GetScorecardResult> {
  const data = await this.makeRequest(`/match/${matchId}/scorecard/`);
  const scorecard = this.normalizeScorecard(matchId, data);

  // Cache TTL based on match status
  const ttl = matchState.state.status === 'completed'
    ? CACHE_TTL.SCORECARD_COMPLETED  // 1 hour
    : CACHE_TTL.SCORECARD_LIVE;      // 30 seconds

  await cache.set(cacheKey, scorecard, ttl);
  return { matchId, scorecard, meta: { provider: 'roanuz', latencyMs } };
}

Normalized to canonical Scorecard type.