GET Upcoming Matches

https://pd.{shard}.a.pvp.net/esports-service/v2/upcomingMatches?leagueID={leagueID}&locale={locale}&sport={sport}

Get upcoming esports matches for VCT leagues. Returns leagues, tournaments, and teams data.

Headers

X-Riot-Entitlements-JWT: {entitlement token}
Authorization: Bearer {auth token}

URL Parameters

{shard}

The shard is dependent on where the Riot account was created.
There are 5 shards:

Shard Region(s)

na latam, br, na
pbe na
eu eu
ap ap
kr kr

Obtaining locally:
The shard can be found in the ShooterGame log (%LocalAppData%\VALORANT\Saved\Logs\ShooterGame.log ) when it's used in an endpoint url.
Example regex capturing region and shard: https://glz-(.+?)-1.(.+?).a.pvp.net
Obtaining remotely:
The shard can be found from using a lookup table with the region. To find the region, use the Riot Geo endpoint with the ID and auth tokens from Cookie Reauth

Shard	Region(s)
`na`	latam, br, na
`pbe`	na
`eu`	eu
`ap`	ap
`kr`	kr

Query Parameters

leagueID required

Comma-separated list of league IDs. Default VCT leagues: 107254585505459304,109940824119741550,109974795266458277,106109559530232966,109974804058058602,111691194187846945,109222784797127274
locale optional

Locale for localized names, e.g. "ru-RU", "en-US"
sport optional

Sport identifier, always "val" for Valorant

Other Variables

entitlement token
Can be obtained locally with the Entitlements Token endpoint or remotely using Riot auth and the Entitlement endpoint
auth token
Can be obtained locally with the Entitlements Token endpoint or remotely by first using the Auth Cookies endpoint then using the cookies with the Auth Request endpoint

Response

type UpcomingMatchesResponse = {
    Leagues: {
        ID: string;
        Name: string;
        ImageURL: string;
        TournamentIDs: string[];
        TeamIDs: string[] | null;
    }[];
    Tournaments: {
        ID: string;
        Name: string;
        LeagueID: string;
        LeagueName: string;
        /** ISO 8601 date string */
        StartTime: string;
        /** ISO 8601 date string */
        EndTime: string;
        StageIDs: string[];
        TeamIDs: string[];
    }[];
    Teams: {
        ID: string;
        Name: string;
        Code: string;
        BaseImageURL: string;
        HighResImageURL: string;
        LowResImageURL: string;
        HomeLeagueID: string;
        TeamMemberIDs: string[] | null;
        BundleID: string;
        BundleDataAssetID: string;
        DataAssetID: string;
    }[];
    Seasons: null;
    Splits: null;
};

{
  "Leagues": [
    {
      "ID": "thesaurus",
      "Name": "Ryan Miller",
      "ImageURL": "https://loremflickr.com/2022/2448?lock=6025129186504424",
      "TournamentIDs": [
        "conqueror",
        "adeptio"
      ],
      "TeamIDs": [
        "acsi",
        "confero",
        "eaque",
        "bibo"
      ]
    },
    {
      "ID": "tribuo",
      "Name": "Marguerite Koss",
      "ImageURL": "https://loremflickr.com/414/3979?lock=5300159794342943",
      "TournamentIDs": [
        "nisi",
        "valens",
        "debeo",
        "strenuus",
        "adipisci"
      ],
      "TeamIDs": [
        "distinctio",
        "strenuus",
        "textor",
        "cognomen",
        "audacia"
      ]
    },
    {
      "ID": "tenax",
      "Name": "Mercedes Lubowitz DDS",
      "ImageURL": "https://picsum.photos/seed/oa3N2yR/28/3159",
      "TournamentIDs": [
        "corrupti"
      ],
      "TeamIDs": [
        "tum",
        "ipsum",
        "tametsi",
        "demonstro"
      ]
    }
  ],
  "Tournaments": [
    {
      "ID": "calamitas",
      "Name": "Candice Roob",
      "LeagueID": "tergiversatio",
      "LeagueName": "aro",
      "StartTime": "decerno",
      "EndTime": "dolorum",
      "StageIDs": [
        "vitae"
      ],
      "TeamIDs": [
        "correptius"
      ]
    },
    {
      "ID": "accusantium",
      "Name": "Carmen Gutkowski",
      "LeagueID": "deripio",
      "LeagueName": "super",
      "StartTime": "decet",
      "EndTime": "via",
      "StageIDs": [
        "spes",
        "surgo",
        "enim",
        "verumtamen",
        "ait"
      ],
      "TeamIDs": [
        "eos",
        "distinctio",
        "suffoco",
        "amaritudo",
        "cogo"
      ]
    },
    {
      "ID": "valeo",
      "Name": "Jerry Satterfield",
      "LeagueID": "civitas",
      "LeagueName": "vallum",
      "StartTime": "aliquid",
      "EndTime": "temperantia",
      "StageIDs": [
        "voveo",
        "delectus",
        "color",
        "aegre"
      ],
      "TeamIDs": [
        "tribuo",
        "conqueror",
        "commodi",
        "baiulus",
        "cogito"
      ]
    }
  ],
  "Teams": [
    {
      "ID": "admitto",
      "Name": "Dwayne Koelpin",
      "Code": "sonitus",
      "BaseImageURL": "timor",
      "HighResImageURL": "amor",
      "LowResImageURL": "cresco",
      "HomeLeagueID": "denique",
      "TeamMemberIDs": [
        "carpo",
        "dignissimos",
        "cupiditate",
        "cras"
      ],
      "BundleID": "baiulus",
      "BundleDataAssetID": "cohors",
      "DataAssetID": "tum"
    },
    {
      "ID": "temporibus",
      "Name": "Brooke Walsh",
      "Code": "quae",
      "BaseImageURL": "xiphias",
      "HighResImageURL": "ultio",
      "LowResImageURL": "sumptus",
      "HomeLeagueID": "acceptus",
      "TeamMemberIDs": [
        "sumptus",
        "arbustum",
        "traho"
      ],
      "BundleID": "possimus",
      "BundleDataAssetID": "acceptus",
      "DataAssetID": "textor"
    },
    {
      "ID": "delinquo",
      "Name": "Becky Considine",
      "Code": "cursim",
      "BaseImageURL": "ullus",
      "HighResImageURL": "complectus",
      "LowResImageURL": "aureus",
      "HomeLeagueID": "universe",
      "TeamMemberIDs": [
        "tondeo"
      ],
      "BundleID": "ager",
      "BundleDataAssetID": "corroboro",
      "DataAssetID": "carmen"
    },
    {
      "ID": "curatio",
      "Name": "Gertrude Grady",
      "Code": "defendo",
      "BaseImageURL": "comprehendo",
      "HighResImageURL": "claro",
      "LowResImageURL": "provident",
      "HomeLeagueID": "vinitor",
      "TeamMemberIDs": [
        "utpote",
        "aestas",
        "tergum",
        "cariosus"
      ],
      "BundleID": "aestivus",
      "BundleDataAssetID": "apparatus",
      "DataAssetID": "demens"
    }
  ],
  "Seasons": null,
  "Splits": null
}