GET Contracts

Headers:

• X-Riot-ClientPlatform: {client platform}
• X-Riot-ClientVersion: {client version}
• 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

• {puuid}
  A player's UUID

Other Variables:

• client platform

  A string representing the platform of the client. Base-64 encoded JSON with the following fields:

  {
      "platformType": "PC",
      "platformOS": "Windows",
      "platformOSVersion": "10.0.19042.1.256.64bit",
      "platformChipset": "Unknown"
  }

  ew0KCSJwbGF0Zm9ybVR5cGUiOiAiUEMiLA0KCSJwbGF0Zm9ybU9TIjogIldpbmRvd3MiLA0KCSJwbGF0Zm9ybU9TVmVyc2lvbiI6ICIxMC4wLjE5MDQyLjEuMjU2LjY0Yml0IiwNCgkicGxhdGZvcm1DaGlwc2V0IjogIlVua25vd24iDQp9 is a value that works.

• client version

  The version of the Valorant client. This can be obtained in a number of ways:

  • Parsing the ShooterGame log at %LocalAppData%\VALORANT\Saved\Logs\ShooterGame.log
  • Using the Sessions endpoint
  • Using the third-party Versions endpoint
• 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 ContractsResponse = {
    Version: number;
    /** Player UUID */
    Subject: string;
    Contracts: {
        /** UUID */
        ContractDefinitionID: string;
        ContractProgression: {
            TotalProgressionEarned: number;
            TotalProgressionEarnedVersion: number;
            HighestRewardedLevel: {
                [x: string]: {
                    Amount: number;
                    Version: number;
                };
            };
        };
        ProgressionLevelReached: number;
        ProgressionTowardsNextLevel: number;
    }[];
    ProcessedMatches: {
        /** Match ID */
        ID: string;
        /** Milliseconds since epoch */
        StartTime: number;
        XPGrants: {
            GamePlayed: number;
            GameWon: number;
            RoundPlayed: number;
            RoundWon: number;
            Missions: {};
            Modifier: {
                Value: number;
                BaseMultiplierValue: number;
                Modifiers: {
                    Value: number;
                    Name: "RESTRICTIONS_XP" | "PREMIUM_CONTRACT_XP";
                    BaseOnly: boolean;
                }[];
            };
            NumAFKRounds: number;
        } | null;
        RewardGrants: {} | null;
        MissionDeltas: {
            [x: string]: {
                /** UUID */
                ID: string;
                Objectives: {
                    [x: string]: number;
                };
                ObjectiveDeltas: {
                    [x: string]: {
                        /** UUID */
                        ID: string;
                        ProgressBefore: number;
                        ProgressAfter: number;
                    };
                };
            };
        } | null;
        ContractDeltas: {
            [x: string]: {
                /** UUID */
                ID: string;
                TotalXPBefore: number;
                TotalXPAfter: number;
            };
        } | null;
        CouldProgressMissions: boolean;
    }[];
    /** UUID */
    ActiveSpecialContract: string;
    Missions: {
        /** UUID */
        ID: string;
        Objectives: {
            [x: string]: number;
        };
        Complete: boolean;
        /** Date in ISO 8601 format */
        ExpirationTime: string;
    }[];
    MissionMetadata: {
        NPECompleted: boolean;
        /** Date in ISO 8601 format */
        WeeklyCheckpoint: string;
        /** Date in ISO 8601 format */
        WeeklyRefillTime: string;
    };
};