Seasons API — GET /v1/seasons endpoints

The Seasons API provides data on Valorant’s episodic content structure. Seasons are organized into episodes (multi-act periods) and acts (roughly six-week ranked play windows). In addition to the standard season list, you can query competitive season data, which maps each act to a specific set of competitive tiers — useful for building rank history tools or tracking how the tier system has evolved across episodes.

The User-Agent header is required for all requests. Use the format AppName/Version (+URL) — for example, MyApp/1.0 (+https://example.com).

Endpoints

Method	Path	Description
GET	`/v1/seasons`	Returns all seasons
GET	`/v1/seasons/{uuid}`	Returns a single season by UUID
GET	`/v1/seasons/competitive`	Returns all competitive season data
GET	`/v1/seasons/competitive/{uuid}`	Returns a single competitive season by UUID

GET /v1/seasons

Returns an array of all Valorant seasons, including episodes and acts.

Request parameters

string

required

Identifies your application. Format: AppName/Version (+URL).

string

default:"en-US"

Locale for localized display names. Example: de-DE, vi-VN.

Example request

curl --request GET \
  --url "https://astra.teamfortuna.xyz/v1/seasons" \
  --header "User-Agent: MyApp/1.0 (+https://example.com)"

curl --request GET \
  --url "https://astra.teamfortuna.xyz/v1/seasons?language=de-DE" \
  --header "User-Agent: MyApp/1.0 (+https://example.com)"

Response

{
  "status": 200,
  "data": [
    {
      "uuid": "3ea2b318-423b-cf86-25da-7cbb0eefbe2d",
      "displayName": "ACT I",
      "title": "",
      "type": "EAresSeasonType::Act",
      "startTime": "2026-01-07T00:00:00Z",
      "endTime": "2026-03-18T00:00:00Z",
      "parentUuid": "15a01c8a-4637-7b7b-de7b-9f906719c020",
      "assetPath": "ShooterGame/Content/Seasons/Season_EpisodeV26-1_Act1_DataAsset"
    }
  ]
}

GET /v1/seasons/

Returns a single season matching the provided UUID.

Request parameters

string

required

The UUID of the season to retrieve.

string

required

Identifies your application. Format: AppName/Version (+URL).

string

default:"en-US"

Locale for localized display names.

Example request

cURL

curl --request GET \
  --url "https://astra.teamfortuna.xyz/v1/seasons/0df5adb9-4dc2-4e28-aac6-edd0eb6a6839" \
  --header "User-Agent: MyApp/1.0 (+https://example.com)"

GET /v1/seasons/competitive

Returns an array of all competitive season records. Each record links a season act to the competitive tier set active during that period.

Request parameters

string

required

Identifies your application. Format: AppName/Version (+URL).

string

default:"en-US"

Locale for localized data.

Example request

cURL

curl --request GET \
  --url "https://astra.teamfortuna.xyz/v1/seasons/competitive" \
  --header "User-Agent: MyApp/1.0 (+https://example.com)"

Response

{
  "status": 200,
  "data": [
    {
      "uuid": "8d9e3688-470b-c0e0-5b20-ca964d907adb",
      "startTime": "2020-04-06T16:00:00Z",
      "endTime": "2020-05-29T06:59:00Z",
      "seasonUuid": "0df5adb9-4dcb-6899-1306-3e9860661dd3",
      "competitiveTiersUuid": "97071510-9fef-31b8-8356-2cc03fdf1bf8",
      "borders": null,
      "assetPath": "ShooterGame/Content/Seasons/Competitive/CompetitiveSeason_CB_DataAsset"
    }
  ]
}

GET /v1/seasons/competitive/

Returns a single competitive season record by UUID.

Request parameters

string

required

The UUID of the competitive season to retrieve.

string

required

Identifies your application. Format: AppName/Version (+URL).

string

default:"en-US"

Locale for localized data.

Example request

cURL

curl --request GET \
  --url "https://astra.teamfortuna.xyz/v1/seasons/competitive/3e47230a-4d87-48b0-beac-6c2c6b9e3c91" \
  --header "User-Agent: MyApp/1.0 (+https://example.com)"

Response fields

Season fields

string

required

Unique identifier for the season.

string

required

Localized display name of the season (e.g., "EPISODE 8 ACT 3").

string

Season type identifier. Common values: "EAresSeasonType::Act", "EAresSeasonType::Episode".

string

ISO 8601 UTC timestamp for the season’s start date.

string

ISO 8601 UTC timestamp for the season’s end date.

string

UUID of the parent episode. Present on act-type seasons; null on episode-type seasons.

string

Internal Unreal Engine asset path.

Competitive season fields

string

required

Unique identifier for the competitive season record.

string

ISO 8601 UTC timestamp for when ranked play opened for this act.

string

ISO 8601 UTC timestamp for when ranked play closed for this act.

string

UUID of the corresponding season act. Use this to join with the /v1/seasons response.

string

UUID of the competitive tier set active during this season. Use this to join with the /v1/competitivetiers response.

string

Internal Unreal Engine asset path.

Use competitiveTiersUuid alongside the Competitive Tiers API to look up the exact ranked ladder (Iron through Radiant) that was in use during any given act.

System

Agents & Characters

Cosmetics

Weapons

Game Data

Premier

Localization

Seasons API — GET /v1/seasons endpoints

Endpoints

GET /v1/seasons

Request parameters

Example request

Response

GET /v1/seasons/

Request parameters

Example request

GET /v1/seasons/competitive

Request parameters

Example request

Response

GET /v1/seasons/competitive/

Request parameters

Example request

Response fields

Season fields

Competitive season fields

​Endpoints

​GET /v1/seasons

​Request parameters

​Example request

​Response

​GET /v1/seasons/

​Request parameters

​Example request

​GET /v1/seasons/competitive

​Request parameters

​Example request

​Response

​GET /v1/seasons/competitive/

​Request parameters

​Example request

​Response fields

​Season fields

​Competitive season fields

Endpoints

GET /v1/seasons

Request parameters

Example request

Response

GET /v1/seasons/

Request parameters

Example request

GET /v1/seasons/competitive

Request parameters

Example request

Response

GET /v1/seasons/competitive/

Request parameters

Example request

Response fields

Season fields

Competitive season fields