---
updatedAt: 2025-12-10T20:08:59.000Z
agentTools:
  siteIndex: https://developer.sportradar.com/llms.txt
  projectIndex: https://developer.sportradar.com/racing/llms.txt
---

# Stage Schedule

**Rally Stage Schedule** provides the schedule for a given stage.

<Callout icon="⏱️" theme="default">
  ### Update Frequency

  300s Time To Live / Cache
</Callout>

***

## Data Points

<Accordion title="Category & Sport" icon="fa-duotone fa-thin fa-flag-checkered">

| Attribute | Parent Element | Type | Description |
| --------- | -------------- | ---- | ----------- |
| `id` | `stage` - `category` | String | Unique category ID for a stage<br /><br />ex. `sr:category:84` (Rally) |
| `name` | `stage` - `category` | String | Name for a stage's category<br /><br />ex. `Formula E` |
| `id` | `stage` - `sport` | String | Unique sport ID for a stage<br /><br />ex. `sr:sport:101` |
| `name` | `stage` - `sport` | String | Name for a stage's sport<br /><br />ex. `Rally` |

</Accordion>

<Accordion title="Stage" icon="fa-duotone fa-thin fa-flag-checkered">

> Stage may be a `sport`, `season`, `event`, `practice`, `qualifying`, `qualifying_part`, `race`, `lap`, or `sprint_race`

| Attribute | Parent Element | Type | Description |
| --------- | -------------- | ---- | ----------- |
| `disabled` | `stage` | Boolean | Signifies a stage has been disabled when `true` |
| `description` | `stage` | String | Name of a stage<br /><br />ex. `World Rally Championship`, `Rally de Monte-Carlo`, or `Day 4` |
| `id` | `stage` | String | Unique ID of a stage<br /><br />ex. `sr:stage:1135404` |
| `scheduled` | `stage` | date-time | Scheduled start time of a stage<br /><br />ex. `2024-02-29T11:30:00+00:00` |
| `scheduled_end` | `stage` | date-time | Scheduled end time of a stage<br /><br />ex. `2024-12-08T15:00:00+00:00` |
| `single_event` | `stage` | Boolean | Signifies a stage is a single event when `true` |
| `status` | `stage` | String | Status of a stage. See our [Rally FAQ](https://developer.sportradar.com/racing/reference/rally-faq#race-statuses) for a list of statuses and their definitions<br /><br />`Cancelled`, `Closed`, `Complete`, `Finished`, `Not Started`, `Preliminary`, `Running` |
| `type` | `stage` | String | Stage type.<br /><br />`sport`, `season`, `event`, `practice`, `qualifying`, `qualifying_part`, `race`, `lap`, `sprint_race` |
| `unique_stage_id` | `stage` | String | Unique ID of a parent stage for an event. Can be used to synch the same event across seasons.<br /><br />ex. `sr:stage_unique:897` |

</Accordion>

<Accordion title="Venue" icon="fa-duotone fa-thin fa-flag-checkered">

| Attribute | Parent Element | Type | Description |
| --------- | -------------- | ---- | ----------- |
| `city` | `venue` | String | City name of a venue<br /><br />ex. `Monaco` |
| `coordinates` | `venue` | String | Coordinates of a venue<br /><br />ex. `43.735386,7.424122` |
| `country` | `venue` | String | Country name of a venue<br /><br />ex. `Monaco` |
| `country_code` | `venue` | String | Country code of a venue<br /><br />ex. `MCO` |
| `id` | `venue` | String | Unique ID of a venue<br /><br />ex. `sr:venue:75915` |
| `length` | `venue` | Integer | Circuit length of a venue, in meterss<br /><br />ex. `3318` |
| `name` | `venue` | String | Name of a venue<br /><br />ex. `Monaco harbour` |
| `state` | `venue` | String | State of a venue<br /><br />ex. `FL` (Florida) |
| `timezone` | `venue` | String | Timezone of a venue<br /><br />ex. `Europe/Monaco` |

</Accordion>

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "rally",
    "version": "3"
  },
  "servers": [
    {
      "url": "https://api.sportradar.com/rally/"
    }
  ],
  "components": {
    "securitySchemes": {
      "sec0": {
        "type": "apiKey",
        "in": "header",
        "name": "x-api-key"
      }
    }
  },
  "security": [
    {
      "sec0": []
    }
  ],
  "paths": {
    "/{access_level}/v2/{language_code}/sport_events/{stage_id}/schedule.{format}": {
      "get": {
        "summary": "Stage Schedule",
        "description": "**Rally Stage Schedule** provides the schedule for a given stage.",
        "operationId": "rally-stage-schedule",
        "parameters": [
          {
            "name": "access_level",
            "in": "path",
            "description": "The access level of your API key<br><br>`trial`, `production`",
            "schema": {
              "type": "string",
              "enum": [
                "trial",
                "production"
              ],
              "default": "trial"
            },
            "required": true
          },
          {
            "name": "language_code",
            "in": "path",
            "description": "2-letter code for supported languages<br><br>`en` (English)<br><br>English is the only fully supported language for this API. Click <span style=\"text-decoration:underline\">[here](https://api-docs.sportradar.us/misc/Sportradar_API_Languages.xlsx)</span> for valid language codes and a tabular list of available languages per competition.",
            "schema": {
              "type": "string",
              "default": "en"
            },
            "required": true
          },
          {
            "name": "stage_id",
            "in": "path",
            "description": "Unique Id of a stage<br><br>**Note:** Visit the <span style=\"text-decoration:underline\">[Stage Types](https://developer.sportradar.com/racing/reference/rally-overview#stage-types)</span> section for valid stages, their sub-stages, and definitions.<br><br>**Example:** `sr:season:1176390`",
            "schema": {
              "type": "string",
              "default": "sr:stage:1223213"
            },
            "required": true
          },
          {
            "name": "format",
            "in": "path",
            "description": "Format returned<br><br>`json`, `xml`",
            "schema": {
              "type": "string",
              "enum": [
                "json",
                "xml"
              ],
              "default": "json"
            },
            "required": true
          }
        ],
        "responses": {
          "200": {
            "description": "200",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": {
                      "generated_at": "2025-12-08T16:49:34.474Z",
                      "schema": "string",
                      "stages": [
                        {
                          "category": {
                            "country_code": "string",
                            "id": "string",
                            "name": "string"
                          },
                          "circuit": "string",
                          "description": "string",
                          "disabled": true,
                          "id": "sr:stage:225553",
                          "scheduled": "2025-12-08T16:49:34.474Z",
                          "scheduled_end": "2025-12-08T16:49:34.474Z",
                          "single_event": true,
                          "sport": {
                            "id": "string",
                            "name": "string"
                          },
                          "stages": [
                            "string"
                          ],
                          "status": "Cancelled",
                          "type": "sport",
                          "unique_stage_id": "string",
                          "venue": {
                            "capacity": 0,
                            "city": "string",
                            "coordinates": "string",
                            "country": "string",
                            "country_code": "string",
                            "id": "string",
                            "name": "string",
                            "state": "string",
                            "timezone": "string",
                            "url_official": "string"
                          }
                        }
                      ]
                    }
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "generated_at": {
                      "type": "string",
                      "example": "2025-12-08T16:49:34.474Z"
                    },
                    "schema": {
                      "type": "string",
                      "example": "string"
                    },
                    "stages": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "category": {
                            "type": "object",
                            "properties": {
                              "country_code": {
                                "type": "string",
                                "example": "string"
                              },
                              "id": {
                                "type": "string",
                                "example": "string"
                              },
                              "name": {
                                "type": "string",
                                "example": "string"
                              }
                            }
                          },
                          "circuit": {
                            "type": "string",
                            "example": "string"
                          },
                          "description": {
                            "type": "string",
                            "example": "string"
                          },
                          "disabled": {
                            "type": "boolean",
                            "example": true,
                            "default": true
                          },
                          "id": {
                            "type": "string",
                            "example": "sr:stage:225553"
                          },
                          "scheduled": {
                            "type": "string",
                            "example": "2025-12-08T16:49:34.474Z"
                          },
                          "scheduled_end": {
                            "type": "string",
                            "example": "2025-12-08T16:49:34.474Z"
                          },
                          "single_event": {
                            "type": "boolean",
                            "example": true,
                            "default": true
                          },
                          "sport": {
                            "type": "object",
                            "properties": {
                              "id": {
                                "type": "string",
                                "example": "string"
                              },
                              "name": {
                                "type": "string",
                                "example": "string"
                              }
                            }
                          },
                          "stages": {
                            "type": "array",
                            "items": {
                              "type": "string",
                              "example": "string"
                            }
                          },
                          "status": {
                            "type": "string",
                            "example": "Cancelled"
                          },
                          "type": {
                            "type": "string",
                            "example": "sport"
                          },
                          "unique_stage_id": {
                            "type": "string",
                            "example": "string"
                          },
                          "venue": {
                            "type": "object",
                            "properties": {
                              "capacity": {
                                "type": "integer",
                                "example": 0,
                                "default": 0
                              },
                              "city": {
                                "type": "string",
                                "example": "string"
                              },
                              "coordinates": {
                                "type": "string",
                                "example": "string"
                              },
                              "country": {
                                "type": "string",
                                "example": "string"
                              },
                              "country_code": {
                                "type": "string",
                                "example": "string"
                              },
                              "id": {
                                "type": "string",
                                "example": "string"
                              },
                              "name": {
                                "type": "string",
                                "example": "string"
                              },
                              "state": {
                                "type": "string",
                                "example": "string"
                              },
                              "timezone": {
                                "type": "string",
                                "example": "string"
                              },
                              "url_official": {
                                "type": "string",
                                "example": "string"
                              }
                            }
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        },
        "deprecated": false
      }
    }
  },
  "x-readme": {
    "headers": [],
    "explorer-enabled": true,
    "proxy-enabled": true
  },
  "x-readme-fauxas": true
}
```