> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sportsapipro.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Cricket — Scorecards & Ball-by-Ball

> Cricket-specific endpoints for batting/bowling scorecards and ball-by-ball commentary

## Scorecards

```text theme={null}
GET /api/v1/match/{matchId}/scorecards
```

Returns batting and bowling scorecards with full player objects (`id`, `name`, `logo`).

<CodeGroup>
  ```bash New canonical theme={null}
  curl -H "x-api-key: YOUR_API_KEY" \
    "https://api.sportsapipro.com/v6/cricket/match/{matchId}/scorecards"
  ```

  ```bash Classic theme={null}
  curl -H "x-api-key: YOUR_API_KEY" \
    "https://api.sportsapipro.com/v6/cricket/match/{matchId}/scorecards"
  ```
</CodeGroup>

**Cache TTL:** 60 s.

## Ball-by-Ball

```text theme={null}
GET /api/v1/match/{matchId}/ball-by-ball
```

Live commentary stream describing every delivery.

```bash theme={null}
curl -H "x-api-key: YOUR_API_KEY" \
  "https://api.sportsapipro.com/v6/cricket/match/{matchId}/ball-by-ball"
```

**Cache TTL:** 5 s.

<Tip>
  Use `/match/{id}/scorecards` for post-innings displays and `/match/{id}/ball-by-ball` for live in-over tickers. Combine with [`/match/{id}`](/api-reference/v6-aiscore/match-detail) for venue, toss, and team metadata.
</Tip>