GET Contracts
https://pd.{shard}.a.pvp.net/contracts/v1/contracts/{puuid} Get contract details including agents, battlepass, missions, and recent games
Headers
-
X-Riot-ClientPlatform: {client platform} -
X-Riot-ClientVersion: {client version} -
X-Riot-Entitlements-JWT: {entitlement token} -
Authorization: Bearer {auth token}
URL Parameters
-
{puuid}A player's UUID
Other Variables
-
client platformA 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" }ew0KCSJwbGF0Zm9ybVR5cGUiOiAiUEMiLA0KCSJwbGF0Zm9ybU9TIjogIldpbmRvd3MiLA0KCSJwbGF0Zm9ybU9TVmVyc2lvbiI6ICIxMC4wLjE5MDQyLjEuMjU2LjY0Yml0IiwNCgkicGxhdGZvcm1DaGlwc2V0IjogIlVua25vd24iDQp9is a value that works. -
client version -
entitlement tokenCan be obtained locally with the Entitlements Token endpoint or remotely using Riot auth and the Entitlement endpoint -
auth tokenCan 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;
};
}; {
"Version": 5133840368385378,
"Subject": "604b6Abd-6E07-0D5a-43A1-32b16BefB3b7",
"Contracts": [
{
"ContractDefinitionID": "98Df140F-30dd-1A1B-C7Fd-9Ed7a70cDdBf",
"ContractProgression": {
"TotalProgressionEarned": 1615392244625326,
"TotalProgressionEarnedVersion": 129776466375566,
"HighestRewardedLevel": {
"perferendis": {
"Amount": 214360332041293,
"Version": 7866226760325185
}
}
},
"ProgressionLevelReached": 600796545364883,
"ProgressionTowardsNextLevel": 6992413655712015
},
{
"ContractDefinitionID": "5FDBDbDB-3Cba-defB-5EDf-F8aE9FDC1de6",
"ContractProgression": {
"TotalProgressionEarned": 4301691681983596,
"TotalProgressionEarnedVersion": 2486945690407211,
"HighestRewardedLevel": {
"strenuus": {
"Amount": 2274430265653285,
"Version": 2193858692308998
}
}
},
"ProgressionLevelReached": 445453633752608,
"ProgressionTowardsNextLevel": 575721096303904
}
],
"ProcessedMatches": [
{
"ID": "D4E589B2-4eD6-EAAc-20fD-dA1D363e5b67",
"StartTime": "+087423-10-17T16:24:19.646Z",
"XPGrants": {
"GamePlayed": 1292134546030622,
"GameWon": 8060914635238340,
"RoundPlayed": 5821236157835692,
"RoundWon": 8217353898741084,
"Missions": {},
"Modifier": {
"Value": 7427198319425409,
"BaseMultiplierValue": 528833065051434,
"Modifiers": [
{
"Value": 7180632088790999,
"Name": "PREMIUM_CONTRACT_XP",
"BaseOnly": false
},
{
"Value": 4973709206217076,
"Name": "RESTRICTIONS_XP",
"BaseOnly": false
},
{
"Value": 6438836538304436,
"Name": "PREMIUM_CONTRACT_XP",
"BaseOnly": false
},
{
"Value": 2969876868838967,
"Name": "PREMIUM_CONTRACT_XP",
"BaseOnly": true
},
{
"Value": 6616808565303973,
"Name": "RESTRICTIONS_XP",
"BaseOnly": false
}
]
},
"NumAFKRounds": 5130984689900826
},
"RewardGrants": {},
"MissionDeltas": {
"a5E5830c-B690-1Be1-fDA7-1CccFeF6E70E": {
"ID": "d29bE7B1-824C-b22e-7F4B-5BCA8E9d2c55",
"Objectives": {
"cF7fE3C7-7dd3-EBFb-742E-7CED7ECcDF7D": 4853264743667114
},
"ObjectiveDeltas": {
"5AbdCb3d-7fBF-Cda9-0FF9-942808F2A3fd": {
"ID": "f3e3a3dc-DdC9-53e1-ECF3-7ee5fe5e3d82",
"ProgressBefore": 7396275055174409,
"ProgressAfter": 5434524260561984
}
}
}
},
"ContractDeltas": {
"9044AAAf-2Acc-bbFE-537e-a3A9Bc9A1bFd": {
"ID": "8CADca48-A0E8-d5B7-ED7c-D5aFc3cF60BD",
"TotalXPBefore": 2049652209017830,
"TotalXPAfter": 3367297372015920
}
},
"CouldProgressMissions": false
}
],
"ActiveSpecialContract": "28F8acD1-84Aa-7ceF-D130-cD6d3EF8f484",
"Missions": [
{
"ID": "a5Ba6bbe-9Bc4-DD81-121B-9D7A965dD65c",
"Objectives": {
"2C5d6afb-Cb5e-bd54-Ea9C-aCD4d8be4ff5": 7045331067297382
},
"Complete": false,
"ExpirationTime": "2026-06-05T20:37:21.808Z"
},
{
"ID": "21D8b047-5d57-eEb0-CBE5-d6ecdde1edBb",
"Objectives": {
"8bAcFfFC-E21D-Fb5F-AA0E-5C9A4DADB20D": 5816115581971923
},
"Complete": false,
"ExpirationTime": "2026-06-06T06:44:09.796Z"
},
{
"ID": "3EB2aBD2-e9Bb-c30D-a26e-b2a1f0128a5D",
"Objectives": {
"F4a15eeC-68a0-2CAB-e3C0-f19Aa771bEfB": 5243395934587508
},
"Complete": false,
"ExpirationTime": "2026-06-05T17:06:39.203Z"
},
{
"ID": "47c7CEe8-5aDB-BA91-dF13-Fdc7b2A37FaA",
"Objectives": {
"5b69dB28-254a-ab2D-8a9D-efcc20F90C7D": 884972180167668
},
"Complete": true,
"ExpirationTime": "2026-06-05T11:00:05.826Z"
}
],
"MissionMetadata": {
"NPECompleted": false,
"WeeklyCheckpoint": "2026-06-05T12:40:27.045Z",
"WeeklyRefillTime": "2026-06-06T10:45:17.958Z"
}
}