---
title: "SofaScore event innings"
method: GET
path: "/sofascore/event-innings"
tags: ["SofaScore"]
---

# SofaScore event innings

`GET /sofascore/event-innings`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/sofascore/event-innings`
- Auth: API key in header `x-api-key`

Returns a cricket match's innings scorecards from SofaScore. Each innings has the batting and bowling teams, runs, wickets, overs in cricket notation (18.4 is 18 overs and 4 balls), extras (wides, no balls, byes, leg byes, penalty), every batter's line (runs, balls, fours, sixes, dismissal with the bowler and fielder, fall-of-wicket score and over), every bowler's figures (overs, maidens, runs, wickets, wides, no balls), the partnerships and a derived fall-of-wickets list. Works for T20, one-day and Test matches (a Test lists up to four innings). Returns 404 when SofaScore has no innings data for the match, which includes matches that have not started and sports other than cricket.

## Query parameters

- `id` string, required

## Headers

- `x-api-key` string, required

## Response `200`

OK

- SofascoreEventInningsResponseDoc
  - `code` integer
  - `data` SofascoreEventInningsResponse
    - `count` integer
    - `event_id` integer
    - `fetched_at` string
    - `innings` SofascoreCricketInnings[]
      - `batting` SofascoreCricketBattingLine[]
        - `balls` integer
        - `bowler` SofascorePlayerBrief
          - `id` integer
          - `jersey_number` string
          - `name` string
          - `position` string
          - `short_name` string
          - `slug` string
        - `dismissal` string: Dismissal is SofaScore's status text: a dismissal such as `Caught`, `Bowled`, `LBW`, `Stumped` or `Hit wicket`, `Not out`, or `Did not bat`.
        - `dismissal_code` integer
        - `fall_of_wicket_over` number
        - `fall_of_wicket_score` integer: FallOfWicketScore and FallOfWicketOver give the team score and over when this batter was dismissed; omitted for batters who were not dismissed.
        - `fielder` SofascorePlayerBrief
          - `id` integer
          - `jersey_number` string
          - `name` string
          - `position` string
          - `short_name` string
          - `slug` string
        - `fours` integer
        - `player` SofascorePlayerBrief
          - `id` integer
          - `jersey_number` string
          - `name` string
          - `position` string
          - `short_name` string
          - `slug` string
        - `runs` integer
        - `scorecard_name` string: ScorecardName is the short name as printed on the scorecard.
        - `sixes` integer
      - `batting_team` SofascoreTeamRef
        - `country` string: Country the team belongs to.
        - `id` integer: SofaScore team id. Use it with the team endpoints.
        - `name` string: Full team name.
        - `national` boolean: True for a national team.
        - `short_name` string: Shortened team name.
        - `slug` string: URL slug of the team on SofaScore.
      - `bowling` SofascoreCricketBowlingLine[]
        - `maidens` integer
        - `no_balls` integer
        - `overs` number: Overs uses cricket notation: 3.4 is three overs and four balls.
        - `player` SofascorePlayerBrief
          - `id` integer
          - `jersey_number` string
          - `name` string
          - `position` string
          - `short_name` string
          - `slug` string
        - `runs` integer
        - `scorecard_name` string
        - `wickets` integer
        - `wides` integer
      - `bowling_team` SofascoreTeamRef
        - `country` string: Country the team belongs to.
        - `id` integer: SofaScore team id. Use it with the team endpoints.
        - `name` string: Full team name.
        - `national` boolean: True for a national team.
        - `short_name` string: Shortened team name.
        - `slug` string: URL slug of the team on SofaScore.
      - `extras` SofascoreCricketExtras
        - `byes` integer
        - `leg_byes` integer
        - `no_balls` integer
        - `penalty` integer
        - `total` integer
        - `wides` integer
      - `fall_of_wickets` SofascoreCricketFallOfWicket[]: FallOfWickets is derived from the batting lines that carry a fall-of-wicket score, ordered by team score and then over, and numbered from 1.
        - `over` number
        - `player` SofascorePlayerBrief
          - `id` integer
          - `jersey_number` string
          - `name` string
          - `position` string
          - `short_name` string
          - `slug` string
        - `score` integer
        - `wicket` integer
      - `id` integer
      - `number` integer
      - `overs` number: Overs uses cricket notation: 18.4 is eighteen overs and four balls.
      - `partnerships` SofascoreCricketPartnership[]
        - `balls` integer
        - `number` integer: Number is the partnership's position in the innings, starting at 1.
        - `player1` SofascorePlayerBrief
          - `id` integer
          - `jersey_number` string
          - `name` string
          - `position` string
          - `short_name` string
          - `slug` string
        - `player2` SofascorePlayerBrief
          - `id` integer
          - `jersey_number` string
          - `name` string
          - `position` string
          - `short_name` string
          - `slug` string
        - `runs` integer
      - `runs` integer
      - `wickets` integer
    - `source_url` string
  - `msg` string

## Other responses

- `400`: Bad Request
- `404`: Not Found
- `429`: Too Many Requests
- `503`: Service Unavailable

---

[API](https://skmtc.dev/crawlora/apis/crawlora-api.md) · [All operations](https://skmtc.dev/crawlora/apis/crawlora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlora/apis/crawlora-api/revisions/0497899e2016?raw)