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

# SofaScore event incidents

`GET /sofascore/event-incidents`

## Request

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

Returns one match's goal, card, substitution, and period timeline from SofaScore. An empty `incidents` list is a valid response before kickoff.

## Query parameters

- `id` string, required

## Headers

- `x-api-key` string, required

## Response `200`

OK

- SofascoreEventIncidentsResponseDoc
  - `code` integer
  - `data` SofascoreEventIncidentsResponse
    - `count` integer: Number of incidents returned.
    - `event_id` integer: SofaScore event (match) id that was requested.
    - `fetched_at` string: Time the data was fetched, in UTC (RFC 3339).
    - `incidents` SofascoreIncident[]: Match timeline of goals, cards, substitutions and period markers.
      - `added_time` integer: Minutes of added time at the point of the incident.
      - `away_score` integer: Away team's score after the incident.
      - `card_color` string: Color of the card, such as `yellow` or `red`. Set for card incidents.
      - `home_score` integer: Home team's score after the incident.
      - `is_home` boolean: Whether the incident belongs to the home team.
      - `player` string: Name of the player involved in the incident.
      - `player_in` string: Name of the player coming on in a substitution.
      - `player_out` string: Name of the player going off in a substitution.
      - `reason` string: Reason SofaScore gives for the incident.
      - `text` string: Short label for the incident, such as `FT` for full time.
      - `time` integer: Match minute at which the incident happened.
      - `type` string: Incident type, such as `period`, `goal`, `card` or `substitution`.
    - `source_url` string: URL the data was read from.
  - `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)