---
title: "SofaScore live events"
method: GET
path: "/sofascore/live-events"
tags: ["SofaScore"]
---

# SofaScore live events

`GET /sofascore/live-events`

## Request

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

Returns currently live events for a sport. The `sport` enum accepts `american-football`, `aussie-rules`, `badminton`, `bandy`, `baseball`, `basketball`, `beach-volley`, `cricket`, `darts`, `esports`, `floorball`, `football`, `futsal`, `handball`, `ice-hockey`, `mma`, `minifootball`, `padel`, `rugby`, `snooker`, `table-tennis`, `tennis`, `volleyball`, and `waterpolo`; the sports endpoint lists them. An empty `events` list is a valid response when nothing is live right now.

## Query parameters

- `sport` 'american-football' | 'aussie-rules' | 'badminton' | 'bandy' | 'baseball' | 'basketball' | 'beach-volley' | 'cricket' | 'darts' | 'esports' | 'floorball' | 'football' | 'futsal' | 'handball' | 'ice-hockey' | 'mma' | 'minifootball' | 'padel' | 'rugby' | 'snooker' | 'table-tennis' | 'tennis' | 'volleyball' | 'waterpolo', required

## Headers

- `x-api-key` string, required

## Response `200`

OK

- SofascoreLiveEventsResponseDoc
  - `code` integer
  - `data` SofascoreLiveEventsResponse
    - `count` integer: Number of events returned.
    - `events` SofascoreEventSummary[]: Matches currently in progress.
      - `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.
      - `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.
      - `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.
    - `sport` string: Sport the events belong to.
  - `msg` string

## Other responses

- `400`: Bad Request
- `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)