SofaScore Substages API

Endpoint facts

Method

GET

API path

/sofascore/stage-substages

Auth

apiKey

Credits

1 credit/request

Charged on

Successful 2xx responses only

Platform

SofaScore

Response schema

#/definitions/sofascore.stageSubstagesResponseDoc

How this endpoint behaves

Query parameters:

• id: required. Numeric SofaScore stage id of a season (for example 214140) or an event (for example 214253).

Notable response behavior:

• A season returns every event of the year with status, dates, info.round, circuit and winner, including canceled and notstarted events. An event returns its sessions: Practice 1 to 3, Qualification, Sprint Qualifying, Sprint and Race for Formula 1, the numbered Stage entries of a cycling race or rally.
• Practice and qualifying sessions can list parts. The parent session of a split qualifying (MotoGP Q1 and Q2) has no results of its own: pass a part id to sofascore/stage-standings.
• A race, a session, a part or a cycling stage has no children and returns 404, as does an unknown id. Walk the hierarchy downwards: competition (stage-seasons), season, event, session.
• Within an event the order follows the schedule; do not infer the type from the position, read type.

Example response (shortened):

{
  "code": 200,
  "msg": "OK",
  "data": {
    "stage_id": 214253,
    "count": 3,
    "source_url": "https://api.sofascore.com/api/v1/stage/214253/substages",
    "fetched_at": "2026-10-07T14:00:00Z",
    "stages": [
      {
        "id": 214258,
        "name": "Grand Prix",
        "slug": "grand-prix",
        "type": {
          "id": 6,
          "name": "Race"
        },
        "status": {
          "type": "finished",
          "description": "Finished"
        },
        "year": "2026",
        "start_timestamp": 1790420400,
        "start_time": "2026-09-26T11:00:00Z",
        "season_name": "Formula 1 2026",
        "country": "Azerbaijan",
        "country_code": "AZ",
        "competition": {
          "id": 40,
          "name": "Formula 1",
          "slug": "formula-1",
          "sport": "motorsport",
          "category_id": 36,
          "category_name": "Formula 1"
        },
        "parent": {
          "id": 214253,
          "name": "Azerbaijan GP",
          "slug": "azerbaijan-gp",
          "start_timestamp": 1790239908
        },
        "info": {
          "circuit": "Baku City Circuit",
          "circuit_country": "Azerbaijan",
          "laps": 51,
          "laps_completed": 51,
          "race_distance_m": 306049,
          "circuit_length_m": 6003,
          "weather": "sunny",
          "track_condition": "Dry",
          "air_temperature": 26.5,
          "track_temperature": 40.1,
          "humidity": 50.4,
          "lap_record": "1:44.916",
          "safety_car": true
        },
        "winner": {
          "id": 271315,
          "name": "George Russell",
          "short_name": "G. Russell",
          "code": "RUS",
          "slug": "russell-george",
          "kind": "individual",
          "country": "United Kingdom",
          "country_code": "GB",
          "team": {
            "id": 214910,
            "name": "Mercedes",
            "short_name": "Mercedes",
            "code": "MER",
            "country": "Germany"
          }
        }
      }
    ]
  }
}

Live monitoring

Monitored request

GET /sofascore/stage-substages?id=214253

Checks passed, 7 days to 14 Oct 2026

100%

Median response time

1.01 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026

GET /sofascore/stage-substages?id=214253

Items in stages

5

Fields filled in every checked item

15

Fields empty in some or all items

2

Shared guides

Related