Endpoint Playground

Try the SofaScore Season Events API

Returns one page (about 30 events) of every fixture or result of a competition season, with the round of each event. The `direction` enum accepts `next` (upcoming fixtures) and `last` (finished results). Follow `has_next_page` to read further pages: a page past the end, a direction with no events (for example `next` in a finished season) and a season id that does not belong to the competition all answer 404. Get `id` from search and `season` from tournament-seasons.

What a live request returned

14 Oct 2026: 30 events; 12 fields had a value in every checked item.

Observed request: GET /sofascore/season-events?direction=last&id=17&season=96668
Fields with a value in every checked item: id, slug, start_timestamp, start_time, status, winner_code, tournament, home_team

Sample value profiles: start_timestamp: 2026-09-12 to 2026-10-12; round: 4 to 6, median 5; start_time: 2026-09-12 to 2026-10-12.

Request: GET /sofascore/season-events
Cost: 1 credit/request
Auth: apiKey
Checks passed, 7 days to 14 Oct 2026: 100%, median 1.07 s
Monitored request: GET /sofascore/season-events?direction=last&id=17&season=96668

SofaScore Season Events API documentation SofaScore platform page Pricing

Prefilled cURL

curl 'https://api.crawlora.net/api/v1/sofascore/season-events?id=17&season=96668&direction=last' \
  -H "x-api-key: $CRAWLORA_API_KEY"

Request parameters

Parameter	Type	Required	Prefilled value	Description
id	string	Yes	17	Numeric SofaScore unique-tournament (competition) id
season	string	Yes	96668	Numeric SofaScore season id
direction	string	Yes	last	Upcoming fixtures or finished results
page	integer	No		Zero-based page number. Defaults to 0

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "tournament_id": 17,
    "season_id": 96668,
    "direction": "last",
    "page": 0,
    "has_next_page": true,
    "count": 1,
    "source_url": "https://api.sofascore.com/api/v1/unique-tournament/17/season/96668/events/last/0",
    "fetched_at": "2026-10-07T14:00:00Z",
    "events": [
      {
        "id": 16363261,
        "slug": "liverpool-fc-ipswich-town",
        "start_timestamp": 1788548400,
        "start_time": "2026-09-04T19:00:00Z",
        "status": {
          "code": 100,
          "description": "Ended",
          "type": "finished"
        },
        "winner_code": 2,
        "tournament": {
          "id": 1,
          "name": "Premier League",
          "unique_tournament_id": 17,
          "unique_tournament_name": "Premier League"
        },
        "home_team": {
          "id": 32,
          "name": "Ipswich Town",
          "short_name": "Ipswich",
          "slug": "ipswich-town",
          "country": "England"
        },
        "away_team": {
          "id": 44,
          "name": "Liverpool FC",
          "short_name": "Liverpool",
          "slug": "liverpool",
          "country": "England"
        },
        "home_score": {
          "current": 0
        },
        "away_score": {
          "current": 2
        },
        "round": 3
      }
    ]
  }
}

More SofaScore endpoints

SofaScore categories for a sport SofaScore competitions in a category SofaScore league draft SofaScore league draft picks SofaScore esports game detail SofaScore event detail SofaScore event at-bat pitches SofaScore event at-bats SofaScore event average positions SofaScore event baseball top performers SofaScore event best players SofaScore event commentary All 109 SofaScore endpoints

The sample response, schema and code snippets below work without an account. Sending a live request needs an API key.

Set up API key Endpoint docs

Endpoint

Choose one catalog endpoint for this request.

1 shown

Group

Method

Auth

Endpoint

GETapiKey1 credit/requestsofascore.seasonEventsResponseDocSofaScore

GET /sofascore/season-events

SofaScore season fixtures and results

Response behavior

- `has_next_page` shows whether `page + 1` holds more events; follow it instead of paging until an error. - Upstream answers 404 for a page past the last one, for a direction with no events (for example `next` for a finished season, or `last` before a season has started) and for a season id that does not belong to the competition. These cannot be told apart, so all three return 404 with an explanatory message. - `round` and `round_name` are set for competitions that play numbered rounds (leagues) and omitted otherwise (for example the NBA). `home_score`/`away_score` are omitted for matches that have not started. - Use `sofascore/round-events` to read a single round, and `sofascore/team-events` for one team's fixtures. Example response (shortened): ```json { "code": 200, "msg": "OK", "data": { "tournament_id": 17, "season_id": 96668, "direction": "last", "page": 0, "has_next_page": true, "count": 1, "source_url": "https://api.sofascore.com/api/v1/unique-tournament/17/season/96668/events/last/0", "fetched_at": "2026-10-07T14:00:00Z", "events": [ { "id": 16363261, "slug": "liverpool-fc-ipswich-town", "start_timestamp": 1788548400, "start_time": "2026-09-04T19:00:00Z", "status": { "code": 100, "description": "Ended", "type": "finished" }, "winner_code": 2, "tournament": { "id": 1, "name": "Premier League", "unique_tournament_id": 17, "unique_tournament_name": "Premier League" }, "home_team": { "id": 32, "name": "Ipswich Town", "short_name": "Ipswich", "slug": "ipswich-town", "country": "England" }, "away_team": { "id": 44, "name": "Liverpool FC", "short_name": "Liverpool", "slug": "liverpool", "country": "England" }, "home_score": { "current": 0 }, "away_score": { "current": 2 }, "round": 3 } ] } } ```

API key required. Paste a full key or rotate one from the API Keys page.

Set up API key

View docs

API key

API key required for live requests. Your key is only used to send requests from this Playground.

not configured

Active Playground key: not configured

Manage API keys in Console

Required query parameters

requiredstring

Numeric SofaScore unique-tournament (competition) idseason

requiredstring

Numeric SofaScore season iddirection

requiredstring

Upcoming fixtures or finished results · allowed: next, last

Add an API key to send a live request.

If an active API key is configured, Copy cURL includes it. Share links never include API keys.

View docs

Sample responseGET

Shown before your first request. Add an API key and send a request to see the live response, status, latency, and headers.

{
  "code": 200,
  "msg": "OK",
  "data": {
    "tournament_id": 17,
    "season_id": 96668,
    "direction": "last",
    "page": 0,
    "has_next_page": true,
    "count": 1,
    "source_url": "https://api.sofascore.com/api/v1/unique-tournament/17/season/96668/events/last/0",
    "fetched_at": "2026-10-07T14:00:00Z",
    "events": [
      {
        "id": 16363261,
        "slug": "liverpool-fc-ipswich-town",
        "start_timestamp": 1788548400,
        "start_time": "2026-09-04T19:00:00Z",
        "status": {
          "code": 100,
          "description": "Ended",
          "type": "finished"
        },
        "winner_code": 2,
        "tournament": {
          "id": 1,
          "name": "Premier League",
          "unique_tournament_id": 17,
          "unique_tournament_name": "Premier League"
        },
        "home_team": {
          "id": 32,
          "name": "Ipswich Town",
          "short_name": "Ipswich",
          "slug": "ipswich-town",
          "country": "England"
        },
        "away_team": {
          "id": 44,
          "name": "Liverpool FC",
          "short_name": "Liverpool",
          "slug": "liverpool",
          "country": "England"
        },
        "home_score": {
          "current": 0
        },
        "away_score": {
          "current": 2
        },
        "round": 3
      }
    ]
  }
}

Try the SofaScore Season Events API

What a live request returned

14 Oct 2026: 30 events; 12 fields had a value in every checked item.

Observed request: GET /sofascore/season-events?direction=last&id=17&season=96668
Fields with a value in every checked item: id, slug, start_timestamp, start_time, status, winner_code, tournament, home_team

Sample value profiles: start_timestamp: 2026-09-12 to 2026-10-12; round: 4 to 6, median 5; start_time: 2026-09-12 to 2026-10-12.

Request: GET /sofascore/season-events
Cost: 1 credit/request
Auth: apiKey
Checks passed, 7 days to 14 Oct 2026: 100%, median 1.07 s
Monitored request: GET /sofascore/season-events?direction=last&id=17&season=96668

SofaScore Season Events API documentation SofaScore platform page Pricing

Prefilled cURL

curl 'https://api.crawlora.net/api/v1/sofascore/season-events?id=17&season=96668&direction=last' \
  -H "x-api-key: $CRAWLORA_API_KEY"

Request parameters

Parameter	Type	Required	Prefilled value	Description
id	string	Yes	17	Numeric SofaScore unique-tournament (competition) id
season	string	Yes	96668	Numeric SofaScore season id
direction	string	Yes	last	Upcoming fixtures or finished results
page	integer	No		Zero-based page number. Defaults to 0

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "tournament_id": 17,
    "season_id": 96668,
    "direction": "last",
    "page": 0,
    "has_next_page": true,
    "count": 1,
    "source_url": "https://api.sofascore.com/api/v1/unique-tournament/17/season/96668/events/last/0",
    "fetched_at": "2026-10-07T14:00:00Z",
    "events": [
      {
        "id": 16363261,
        "slug": "liverpool-fc-ipswich-town",
        "start_timestamp": 1788548400,
        "start_time": "2026-09-04T19:00:00Z",
        "status": {
          "code": 100,
          "description": "Ended",
          "type": "finished"
        },
        "winner_code": 2,
        "tournament": {
          "id": 1,
          "name": "Premier League",
          "unique_tournament_id": 17,
          "unique_tournament_name": "Premier League"
        },
        "home_team": {
          "id": 32,
          "name": "Ipswich Town",
          "short_name": "Ipswich",
          "slug": "ipswich-town",
          "country": "England"
        },
        "away_team": {
          "id": 44,
          "name": "Liverpool FC",
          "short_name": "Liverpool",
          "slug": "liverpool",
          "country": "England"
        },
        "home_score": {
          "current": 0
        },
        "away_score": {
          "current": 2
        },
        "round": 3
      }
    ]
  }
}

SofaScore season fixtures and results

Response behavior

API key required. Paste a full key or rotate one from the API Keys page.

Set up API key

{ "code": 200, "msg": "OK", "data": { "tournament_id": 17, "season_id": 96668, "direction": "last", "page": 0, "has_next_page": true, "count": 1, "source_url": "https://api.sofascore.com/api/v1/unique-tournament/17/season/96668/events/last/0", "fetched_at": "2026-10-07T14:00:00Z", "events": [ { "id": 16363261, "slug": "liverpool-fc-ipswich-town", "start_timestamp": 1788548400, "start_time": "2026-09-04T19:00:00Z", "status": { "code": 100, "description": "Ended", "type": "finished" }, "winner_code": 2, "tournament": { "id": 1, "name": "Premier League", "unique_tournament_id": 17, "unique_tournament_name": "Premier League" }, "home_team": { "id": 32, "name": "Ipswich Town", "short_name": "Ipswich", "slug": "ipswich-town", "country": "England" }, "away_team": { "id": 44, "name": "Liverpool FC", "short_name": "Liverpool", "slug": "liverpool", "country": "England" }, "home_score": { "current": 0 }, "away_score": { "current": 2 }, "round": 3 } ] } }