# Get every ball of an innings (v1)

Returns every ball of one innings with batter, bowler, runs and wickets, the batters and bowlers in it and the innings score. Null before the innings starts.

- Platform: Cricbuzz
- Request: `GET https://api.toolzerhub.com/v1/cricbuzz/match/balls`
- Auth: `x-api-key` header
- Cost: 1 credit per successful request. Failed requests are not billed.
- Page: https://docs.toolzerhub.com/reference/cricbuzz/match-centre/get-ball-map

| Parameter | In | Required | Type | Description |
| --- | --- | --- | --- | --- |
| `match_id` | query | yes | integer | Match id, from Get Live Matches, Get Recent Matches, a series or a team schedule. |
| `innings` | query | no | integer | Innings number: 1 for the first innings, 2 for the second, up to 4 in a Test (5 and 6 cover super overs). Default: 1. |

## Example request

```bash
curl "https://api.toolzerhub.com/v1/cricbuzz/match/balls?match_id=<match_id>" \
  -H "x-api-key: $TOOLZERHUB_API_KEY"
```

Success responses are wrapped as `{ "data": ... }`. Errors return `{ "error": { "code", "status", "message", "retryable", "details" } }`. See https://docs.toolzerhub.com/docs/responses-and-errors.