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

# SofaScore event detail

`GET /sofascore/event`

## Request

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

Returns one SofaScore match by event id: home and away teams and scores, status, start time, tournament, attendance and winner code, plus venue and referee when SofaScore has them. An unknown or malformed id surfaces as an upstream error.

## Query parameters

- `id` string, required

## Headers

- `x-api-key` string, required

## Response `200`

OK

- SofascoreEventResponseDoc
  - `code` integer
  - `data` SofascoreEventResponse
    - `event` SofascoreEventDetail
      - `attendance` integer: Reported attendance.
      - `away_score` SofascoreScoreLine
        - `current` integer: Current score, which is the final score once the match is over.
        - `period1` integer: Score in the first period.
        - `period2` integer: Score in the second period.
      - `away_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.
      - `home_score` SofascoreScoreLine
        - `current` integer: Current score, which is the final score once the match is over.
        - `period1` integer: Score in the first period.
        - `period2` integer: Score in the second period.
      - `home_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.
      - `id` integer: SofaScore event id. Use it with the event endpoints.
      - `referee` SofascoreReferee
        - `country` string: Referee's country.
        - `id` integer: SofaScore referee id.
        - `name` string: Referee's name.
      - `slug` string: URL slug of the match on SofaScore.
      - `start_time` string: Start time in UTC (RFC 3339).
      - `start_timestamp` integer: Start time as a Unix timestamp in seconds.
      - `status` SofascoreEventStatus
        - `code` integer: SofaScore's numeric status code, for example 0 for not started and 100 for ended.
        - `description` string: Status as displayed, for example "Ended".
        - `type` string: Status group, for example `notstarted`, `inprogress` or `finished`.
      - `tournament` SofascoreTournamentRef
        - `category` string: Category the tournament sits under, usually a country or region.
        - `id` integer: SofaScore id of the tournament the match is filed under. The seasons, standings and round endpoints take `unique_tournament_id` instead.
        - `name` string: Tournament name.
        - `slug` string: URL slug of the tournament on SofaScore.
        - `unique_tournament_id` integer: Id of the parent competition. This is the tournament id the tournament-seasons, standings and round-events endpoints take.
        - `unique_tournament_name` string: Name of the parent competition.
      - `venue` SofascoreVenue
        - `capacity` integer: Venue capacity.
        - `city` string: City the venue is in.
        - `country` string: Country the venue is in.
        - `name` string: Venue name.
      - `winner_code` integer: Result code: 1 when the home side won, 2 when the away side won, 3 for a draw. Omitted until the match is decided.
    - `fetched_at` string: Time the data was fetched, in UTC (RFC 3339).
    - `source_url` string: SofaScore 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)