Endpoint Playground

Try the SofaScore Stage Schedule API

Returns the events SofaScore lists for a stage sport around a UTC date: Grand Prix weekends, NASCAR race weekends, rallies and cycling races, each with its country, competition, every session start time (`session_start_timestamps`) and the session SofaScore highlights (`session`: the live, next or latest one). The list is not a strict one-day filter. It holds the events in progress on the date plus the next upcoming ones, and a quiet date still returns the next events; use `on_date`, which is true when a session of the event starts inside the requested UTC day, to separate them. Schedule rows carry no event status or winner: use `session.status`, or pass the event `id` to stage for the event detail and to stage-substages for its sessions. `date` must be a real calendar date written `YYYY-MM-DD`. An empty `stages` list is valid when nothing is in progress or scheduled nearby. The `sport` enum accepts `motorsport` and `cycling`.

What a live request returned

14 Oct 2026: 6 stages; 10 fields had a value in every checked item.

Observed request: GET /sofascore/stage-schedule?date=2026-10-13&sport=motorsport
Fields with a value in every checked item: id, name, slug, type, country, country_code, competition, session_start_timestamps

Sample value profiles: country: USA (5), Spain (1); name: “Grand Prix of Spain” and 3 other values; on_date: true in 0 of 6.

Request: GET /sofascore/stage-schedule
Cost: 1 credit/request
Auth: apiKey
Checks passed, 7 days to 14 Oct 2026: 100%, median 1.01 s
Monitored request: GET /sofascore/stage-schedule?date=2026-10-04&sport=motorsport

SofaScore Stage Schedule API documentation SofaScore platform page Pricing

Prefilled cURL

curl 'https://api.crawlora.net/api/v1/sofascore/stage-schedule?sport=motorsport&date=2026-10-04' \
  -H "x-api-key: $CRAWLORA_API_KEY"

Request parameters

Parameter	Type	Required	Prefilled value	Description
sport	string	Yes	motorsport	Stage sport key
date	string	Yes	2026-10-04	UTC calendar date, YYYY-MM-DD

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "sport": "motorsport",
    "date": "2026-10-04",
    "count": 1,
    "source_url": "https://api.sofascore.com/api/v1/stage/sport/motorsport/scheduled/2026-10-04",
    "fetched_at": "2026-10-07T14:00:00Z",
    "stages": [
      {
        "id": 214260,
        "name": "Singapore GP",
        "slug": "singapore-gp",
        "type": {
          "id": 2,
          "name": "Event"
        },
        "country": "Singapore",
        "country_code": "SG",
        "competition": {
          "id": 40,
          "name": "Formula 1",
          "slug": "formula-1",
          "sport": "motorsport",
          "category_id": 36,
          "category_name": "Formula 1"
        },
        "session_start_timestamps": [
          1791534600,
          1791540060,
          1791549000,
          1791622800,
          1791626400,
          1791637200,
          1791720000
        ],
        "on_date": false,
        "session": {
          "id": 214261,
          "name": "Practice 1",
          "slug": "practice-1",
          "type": {
            "id": 3,
            "name": "Practice"
          },
          "status": {
            "type": "notstarted",
            "description": "Not started"
          },
          "start_timestamp": 1791534600
        }
      }
    ]
  }
}

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.stageScheduleResponseDocSofaScore

GET /sofascore/stage-schedule

SofaScore motorsport and cycling events around a date

Response behavior

- The list is not a strict one-day filter. It contains the events in progress on the date plus the next upcoming ones, so a quiet date still returns the next events (on 2026-10-07 every returned event started two or more days later). `on_date` is true when at least one session of the event starts inside the requested UTC day; filter on it for a strict day view. - `session_start_timestamps` lists every session start of the event (Unix seconds). `session` is the session SofaScore highlights: the live one, otherwise the next or the latest. Schedule rows carry no event `status`, `winner` or `start_timestamp`; read the session status, or pass the event `id` to `sofascore/stage` or `sofascore/stage-substages`. - An empty `stages` list is valid: no event is in progress or scheduled nearby (for example a date in the off season such as 2026-01-01, or 1999-01-01). - The upstream answers 200 with an empty list for sports that do not use stages, which is why `sport` is validated here instead of passed through. Example response (shortened): ```json { "code": 200, "msg": "OK", "data": { "sport": "motorsport", "date": "2026-10-04", "count": 1, "source_url": "https://api.sofascore.com/api/v1/stage/sport/motorsport/scheduled/2026-10-04", "fetched_at": "2026-10-07T14:00:00Z", "stages": [ { "id": 214260, "name": "Singapore GP", "slug": "singapore-gp", "type": { "id": 2, "name": "Event" }, "country": "Singapore", "country_code": "SG", "competition": { "id": 40, "name": "Formula 1", "slug": "formula-1", "sport": "motorsport", "category_id": 36, "category_name": "Formula 1" }, "session_start_timestamps": [ 1791534600, 1791540060, 1791549000, 1791622800, 1791626400, 1791637200, 1791720000 ], "on_date": false, "session": { "id": 214261, "name": "Practice 1", "slug": "practice-1", "type": { "id": 3, "name": "Practice" }, "status": { "type": "notstarted", "description": "Not started" }, "start_timestamp": 1791534600 } } ] } } ```

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

sport

requiredstring

Stage sport key · allowed: motorsport, cyclingdate

requiredstring

UTC calendar date, YYYY-MM-DD

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": {
    "sport": "motorsport",
    "date": "2026-10-04",
    "count": 1,
    "source_url": "https://api.sofascore.com/api/v1/stage/sport/motorsport/scheduled/2026-10-04",
    "fetched_at": "2026-10-07T14:00:00Z",
    "stages": [
      {
        "id": 214260,
        "name": "Singapore GP",
        "slug": "singapore-gp",
        "type": {
          "id": 2,
          "name": "Event"
        },
        "country": "Singapore",
        "country_code": "SG",
        "competition": {
          "id": 40,
          "name": "Formula 1",
          "slug": "formula-1",
          "sport": "motorsport",
          "category_id": 36,
          "category_name": "Formula 1"
        },
        "session_start_timestamps": [
          1791534600,
          1791540060,
          1791549000,
          1791622800,
          1791626400,
          1791637200,
          1791720000
        ],
        "on_date": false,
        "session": {
          "id": 214261,
          "name": "Practice 1",
          "slug": "practice-1",
          "type": {
            "id": 3,
            "name": "Practice"
          },
          "status": {
            "type": "notstarted",
            "description": "Not started"
          },
          "start_timestamp": 1791534600
        }
      }
    ]
  }
}

Try the SofaScore Stage Schedule API

What a live request returned

14 Oct 2026: 6 stages; 10 fields had a value in every checked item.

Observed request: GET /sofascore/stage-schedule?date=2026-10-13&sport=motorsport
Fields with a value in every checked item: id, name, slug, type, country, country_code, competition, session_start_timestamps

Sample value profiles: country: USA (5), Spain (1); name: “Grand Prix of Spain” and 3 other values; on_date: true in 0 of 6.

Request: GET /sofascore/stage-schedule
Cost: 1 credit/request
Auth: apiKey
Checks passed, 7 days to 14 Oct 2026: 100%, median 1.01 s
Monitored request: GET /sofascore/stage-schedule?date=2026-10-04&sport=motorsport

SofaScore Stage Schedule API documentation SofaScore platform page Pricing

Prefilled cURL

curl 'https://api.crawlora.net/api/v1/sofascore/stage-schedule?sport=motorsport&date=2026-10-04' \
  -H "x-api-key: $CRAWLORA_API_KEY"

Request parameters

Parameter	Type	Required	Prefilled value	Description
sport	string	Yes	motorsport	Stage sport key
date	string	Yes	2026-10-04	UTC calendar date, YYYY-MM-DD

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "sport": "motorsport",
    "date": "2026-10-04",
    "count": 1,
    "source_url": "https://api.sofascore.com/api/v1/stage/sport/motorsport/scheduled/2026-10-04",
    "fetched_at": "2026-10-07T14:00:00Z",
    "stages": [
      {
        "id": 214260,
        "name": "Singapore GP",
        "slug": "singapore-gp",
        "type": {
          "id": 2,
          "name": "Event"
        },
        "country": "Singapore",
        "country_code": "SG",
        "competition": {
          "id": 40,
          "name": "Formula 1",
          "slug": "formula-1",
          "sport": "motorsport",
          "category_id": 36,
          "category_name": "Formula 1"
        },
        "session_start_timestamps": [
          1791534600,
          1791540060,
          1791549000,
          1791622800,
          1791626400,
          1791637200,
          1791720000
        ],
        "on_date": false,
        "session": {
          "id": 214261,
          "name": "Practice 1",
          "slug": "practice-1",
          "type": {
            "id": 3,
            "name": "Practice"
          },
          "status": {
            "type": "notstarted",
            "description": "Not started"
          },
          "start_timestamp": 1791534600
        }
      }
    ]
  }
}

SofaScore motorsport and cycling events around a date

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": { "sport": "motorsport", "date": "2026-10-04", "count": 1, "source_url": "https://api.sofascore.com/api/v1/stage/sport/motorsport/scheduled/2026-10-04", "fetched_at": "2026-10-07T14:00:00Z", "stages": [ { "id": 214260, "name": "Singapore GP", "slug": "singapore-gp", "type": { "id": 2, "name": "Event" }, "country": "Singapore", "country_code": "SG", "competition": { "id": 40, "name": "Formula 1", "slug": "formula-1", "sport": "motorsport", "category_id": 36, "category_name": "Formula 1" }, "session_start_timestamps": [ 1791534600, 1791540060, 1791549000, 1791622800, 1791626400, 1791637200, 1791720000 ], "on_date": false, "session": { "id": 214261, "name": "Practice 1", "slug": "practice-1", "type": { "id": 3, "name": "Practice" }, "status": { "type": "notstarted", "description": "Not started" }, "start_timestamp": 1791534600 } } ] } }