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" | "SOCIAL_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": 3402608229528831,
"Subject": "3e3e8cCB-fC9f-cd94-B2bA-25C79C407fb5",
"Contracts": [
{
"ContractDefinitionID": "8D211db4-bcDA-E3E2-40Cb-B0AcA3b84E2C",
"ContractProgression": {
"TotalProgressionEarned": 6738917274224802,
"TotalProgressionEarnedVersion": 6243193745878641,
"HighestRewardedLevel": {
"studio": {
"Amount": 8846490832056095,
"Version": 6853626445025882
}
}
},
"ProgressionLevelReached": 5625734706149720,
"ProgressionTowardsNextLevel": 3175954800286436
}
],
"ProcessedMatches": [
{
"ID": "d199E23F-EFA4-91fC-EC37-7AFB0cdBBb0C",
"StartTime": "+192539-10-19T22:10:48.838Z",
"XPGrants": {
"GamePlayed": 4268172512462365,
"GameWon": 3238979881053333,
"RoundPlayed": 133696438947884,
"RoundWon": 6107206701486253,
"Missions": {},
"Modifier": {
"Value": 8320982270418903,
"BaseMultiplierValue": 5733960304164345,
"Modifiers": [
{
"Value": 6233687487670376,
"Name": "SOCIAL_XP",
"BaseOnly": false
}
]
},
"NumAFKRounds": 1722194439168578
},
"RewardGrants": {},
"MissionDeltas": {
"EB4d0d1A-5Ebf-9be9-9462-Abd4FadE3500": {
"ID": "0ca30DAb-9C12-d3eE-6F48-EB8dCadA8af9",
"Objectives": {
"BAfdAd6B-98E2-ac24-dCFb-c2FDcADA487d": 444649337146088
},
"ObjectiveDeltas": {
"e90E1D3A-F55D-fcbd-722b-2c476Df9Aa4e": {
"ID": "FE2f82fE-CfA2-ed5e-E299-640c32EeBE3C",
"ProgressBefore": 6296872191188427,
"ProgressAfter": 7159007724793301
}
}
}
},
"ContractDeltas": {
"A58FbE5c-9c6A-08Eb-cA0D-6877eaBec524": {
"ID": "50BF20BC-5Dc5-D79f-afB7-D1E6b0BD6fCe",
"TotalXPBefore": 8198300773027426,
"TotalXPAfter": 5082239643385689
}
},
"CouldProgressMissions": false
},
{
"ID": "4a96eFe4-C8DB-7d2e-b9d5-e51fCfD5c55f",
"StartTime": "+254150-04-24T15:29:45.060Z",
"XPGrants": {
"GamePlayed": 2416587121970994,
"GameWon": 4379818733123030,
"RoundPlayed": 6041999591169638,
"RoundWon": 4055284008642623,
"Missions": {},
"Modifier": {
"Value": 8899727312287912,
"BaseMultiplierValue": 1941458700988535,
"Modifiers": [
{
"Value": 5693019329869282,
"Name": "SOCIAL_XP",
"BaseOnly": false
},
{
"Value": 3418324218458331,
"Name": "SOCIAL_XP",
"BaseOnly": false
},
{
"Value": 4098758096160092,
"Name": "PREMIUM_CONTRACT_XP",
"BaseOnly": false
}
]
},
"NumAFKRounds": 5298135200269334
},
"RewardGrants": {},
"MissionDeltas": {
"481b6720-b8c7-Ad0c-a3cD-AfA4Adee8f3a": {
"ID": "d33fe6C7-1088-4A2F-acFa-E727c9aF04d1",
"Objectives": {
"ff8d2cD0-c0D7-be5f-4052-58105Dcb53dF": 3117616507154278
},
"ObjectiveDeltas": {
"E39d92Ae-292B-cdB4-bD61-0C0BCd14EE7e": {
"ID": "DA6D9DaD-A73c-645B-d2ae-152F9d311122",
"ProgressBefore": 4788417071797829,
"ProgressAfter": 2458998197779114
}
}
}
},
"ContractDeltas": {
"f4c94a7A-eDD0-F64E-D9Bd-dbDF66DFCbcd": {
"ID": "4a632276-6B65-42CE-8Ab3-ddbb18df73fC",
"TotalXPBefore": 4955327933059986,
"TotalXPAfter": 8907323187493034
}
},
"CouldProgressMissions": false
},
{
"ID": "Ac7852Ee-58Cc-dD2F-CEdC-AcC1FBc9D3CC",
"StartTime": "+028283-04-21T10:31:39.975Z",
"XPGrants": {
"GamePlayed": 1142358267338389,
"GameWon": 5340668589769167,
"RoundPlayed": 7016242664072937,
"RoundWon": 51640145113560,
"Missions": {},
"Modifier": {
"Value": 6040233054730319,
"BaseMultiplierValue": 948682400755351,
"Modifiers": [
{
"Value": 2951915565023374,
"Name": "SOCIAL_XP",
"BaseOnly": true
}
]
},
"NumAFKRounds": 2265322224388905
},
"RewardGrants": {},
"MissionDeltas": {
"AC4ccD4b-FB9b-CDAc-fE51-BFA40CFf2fb6": {
"ID": "AdeEC2A7-ae3D-2985-3ED1-53Be2e539F2d",
"Objectives": {
"01bE4FFD-eE0C-26aE-764e-aD8BD6eAA8e3": 4223930006479599
},
"ObjectiveDeltas": {
"0b4B04EA-E2cA-E4D4-8DC0-0e7bC4F20f5f": {
"ID": "E3eA6Caf-885A-993C-263F-05e6CB31a2dE",
"ProgressBefore": 8962918308381185,
"ProgressAfter": 3832016124522799
}
}
}
},
"ContractDeltas": {
"d11a174C-fc9C-19c2-Af02-86aee69e7D8b": {
"ID": "E8E6F4CC-199B-75dC-Bf27-aEDdEA6bBdee",
"TotalXPBefore": 5078778152707647,
"TotalXPAfter": 6024896552536071
}
},
"CouldProgressMissions": true
},
{
"ID": "DE63bBFf-C135-FbE9-47E9-6035F9f9eA6e",
"StartTime": "+240431-07-04T05:36:44.166Z",
"XPGrants": {
"GamePlayed": 5269558093691606,
"GameWon": 8757150384820318,
"RoundPlayed": 4593499867210301,
"RoundWon": 211343157460647,
"Missions": {},
"Modifier": {
"Value": 3149148186716819,
"BaseMultiplierValue": 40268358426150,
"Modifiers": [
{
"Value": 2415074348334389,
"Name": "SOCIAL_XP",
"BaseOnly": true
},
{
"Value": 577348569705674,
"Name": "PREMIUM_CONTRACT_XP",
"BaseOnly": false
},
{
"Value": 2535914849813488,
"Name": "SOCIAL_XP",
"BaseOnly": true
}
]
},
"NumAFKRounds": 5441736215464409
},
"RewardGrants": {},
"MissionDeltas": {
"93FB0b0a-f514-6B3D-F5D6-b1CfbB2E0503": {
"ID": "fAEeb763-06E5-8dF1-E5BE-d300b0B2925f",
"Objectives": {
"fBA1b8af-ECfE-eCd0-eA63-8D2bcE2aDA80": 7849695381085851
},
"ObjectiveDeltas": {
"bC604d3E-CCE3-AEdD-a9ed-AdaFdd5F121D": {
"ID": "1deBf269-bcaE-AC78-3F4c-0976c7f73Ed9",
"ProgressBefore": 7661578432418062,
"ProgressAfter": 4025043521816021
}
}
}
},
"ContractDeltas": {
"7DCC81CC-dDcD-dbEb-22D1-dEBb45a0a105": {
"ID": "6CFA80D4-bf63-48Bd-F3e2-CFeCf42486fb",
"TotalXPBefore": 772094376508431,
"TotalXPAfter": 5449850043630386
}
},
"CouldProgressMissions": true
}
],
"ActiveSpecialContract": "b88Ba692-30ea-aeaF-D8cA-be116ceE3d9D",
"Missions": [
{
"ID": "cf622Ba2-88fA-3Ac9-1f4B-0fcaEbEDa88b",
"Objectives": {
"De9831c1-Ab68-0644-AA8e-DEBEE499C6fa": 7321818329458187
},
"Complete": true,
"ExpirationTime": "2026-09-29T20:47:05.022Z"
}
],
"MissionMetadata": {
"NPECompleted": true,
"WeeklyCheckpoint": "2026-09-29T18:53:55.895Z",
"WeeklyRefillTime": "2026-09-30T07:03:12.356Z"
}
}