Updated on 2026-05-12 NovaDataHub Engineering
Developer docs

Cricket Scorecard Endpoint

The cricket scorecard endpoint is where a match listing becomes detailed structured sports data. Use it when you need innings, batsmen, bowlers, and richer match context for product surfaces or analytics.

Key points

  • Scorecard requests depend on a match ID from the matches listing endpoint.
  • Detailed structures are useful for score views, recaps, and player-level product features.
  • The endpoint works best when your app separates listing flows from detail-page fetches.

Common errors

  • 401 invalid_key
  • 404 match_not_found
  • 429 rate_limited
  • 500 data_source_failed
Reference details

Parameters, response shape, and operational notes

Parameter notes

  • id is the required route parameter and should come from the matches endpoint.
  • Keep the listing payload around long enough to connect users or jobs to the correct scorecard target.
  • Scorecards are usually heavier than summaries, so use them where deeper detail is actually needed.

Response highlights

  • Look for innings arrays, batsmen structures, bowler structures, and match context fields.
  • Player-level rendering is much easier when you preserve the response shape rather than flattening too early.
  • Sports products often use scorecards differently from summary widgets, so model the two flows separately.

Operational notes

  • Treat scorecards as a detail fetch path rather than your only cricket endpoint.
  • Cache or refresh scorecards at a cadence that matches the product experience you are building.
  • Store the match identifier and collection timestamp with the scorecard if you plan to analyze historical states later.

Implementation checklist

  • Fetch a live match list first and save a known match ID for testing.
  • Render one scorecard end to end before designing generalized player or innings abstractions.
  • Add summary endpoints separately for lighter product surfaces instead of forcing every view through the scorecard response.
Code examples

Visible integration examples

curl

curl -s -H "x-api-key: YOUR_API_KEY" "https://novadatahub.com/api/cricket/match/12345/scorecard"

Python

import requests
resp = requests.get('https://novadatahub.com/api/cricket/match/12345/scorecard', headers={'x-api-key': 'YOUR_API_KEY'}, timeout=60)
print(resp.json())

C# HttpClient

using System.Net.Http.Json;
using System.Text.Json;
using var http = new HttpClient();
http.DefaultRequestHeaders.Add("x-api-key", "YOUR_API_KEY");
var json = await http.GetFromJsonAsync<JsonElement>("https://novadatahub.com/api/cricket/match/12345/scorecard");
Console.WriteLine(json.ToString());

Sample JSON response

{
  "ok": true,
  "match": { "id": "12345", "status": "Live" },
  "innings": [
    { "team": "IND", "runs": 187, "wkts": 4, "overs": "19.3" }
  ]
}
Related resources

Move from reference docs into the next relevant workflow

Cricket Scores API landing page

Open the public overview page for live match lists, summaries, and structured scorecard data.

Open landing page

Live cricket scores solution

See how match-list and score widget workflows map to a product-ready cricket API integration.

Open use case

Cricket scorecard solution

Read the use-case page for deeper innings, batting, and bowling detail in cricket products.

Open use case

Rate-limit handling

Use the shared operational guide when polling-heavy sports workflows need calmer retry and refresh behavior.

Open guide
Related links

Continue with connected pages

Cricket Scores API

Open the related NovaDataHub page for deeper documentation, comparisons, or implementation guidance.

Cricket Scores docs

Open the related NovaDataHub page for deeper documentation, comparisons, or implementation guidance.

Cricket scorecard solution

Open the related NovaDataHub page for deeper documentation, comparisons, or implementation guidance.

Cricket widget API

Open the related NovaDataHub page for deeper documentation, comparisons, or implementation guidance.