curl -X GET "https://api.fitsociety.io/public/v1/workout/clients/{clientId}/weekly-ranking" \
-H "Authorization: Bearer <access_token>"const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.fitsociety.io/public/v1/workout/clients/{clientId}/weekly-ranking', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.fitsociety.io/public/v1/workout/clients/{clientId}/weekly-ranking"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"data": {
"enabled": true,
"hidden": false,
"isCurrentWeek": true,
"resetLabel": "Reset in 4 days - Sunday Midnight",
"weekStart": "2026-07-12T00:00:00.000Z",
"weekEnd": "2026-07-19T00:00:00.000Z",
"podium": [
{
"rank": 4,
"clientId": "67f1234567890abcdef1234",
"firstName": "Kaylynn",
"lastName": "Lubin",
"name": "Kaylynn Lubin",
"image": "https://cdn.example.com/4.jpg",
"xp": 3895,
"trend": "up",
"anonymousAvatar": false,
"isCurrentUser": false
}
],
"data": [
{
"rank": 4,
"clientId": "67f1234567890abcdef1234",
"firstName": "Kaylynn",
"lastName": "Lubin",
"name": "Kaylynn Lubin",
"image": "https://cdn.example.com/4.jpg",
"xp": 3895,
"trend": "up",
"anonymousAvatar": false,
"isCurrentUser": false
}
],
"currentUser": {
"rank": 200,
"clientId": "67f1234567890abcdef1234",
"firstName": "Wilson",
"lastName": "Calzoni",
"name": "Wilson Calzoni",
"image": "https://cdn.example.com/you.jpg",
"anonymousAvatar": false,
"xp": 320,
"trend": "down",
"nextRank": 199,
"nextRankValue": 340,
"xpToNextRank": 20,
"progressToNextRank": 0.94,
"participating": true,
"inCurrentPage": false,
"isCurrentUser": true
},
"avatars": [
{
"clientId": "67f1234567890abcdef1234",
"image": "https://cdn.example.com/clients/a1.jpg",
"name": "Bryan Wolf"
}
],
"totalCount": 213,
"othersCount": 210,
"pagination": {
"page": 1,
"limit": 10,
"totalPages": 16,
"totalItems": 153,
"hasNextPage": true,
"hasPreviousPage": false,
"nextPage": 2,
"previousPage": false,
"totalAvailableItems": 1
},
"availableFilters": {
"gender": [
{
"key": "male",
"label": "Male"
},
{
"key": "female",
"label": "Female"
},
{
"key": "prefer_not_to_say",
"label": "Prefer not to say"
}
],
"scoringType": [
{
"key": "standard",
"label": "Standard"
},
{
"key": "forTime",
"label": "For Time"
},
{
"key": "amrap",
"label": "AMRAP"
},
{
"key": "emom",
"label": "EMOM"
},
{
"key": "tabata",
"label": "Tabata"
},
{
"key": "maxLoad",
"label": "Max Load"
}
],
"allowedDivisions": [
{
"key": "rx",
"label": "RX"
},
{
"key": "scaled",
"label": "Scaled"
},
{
"key": "rx_scaled",
"label": "RX & Scaled"
}
]
},
"selectedFilters": {
"gender": "female",
"scoringType": "maxLoad",
"allowedDivisions": null
}
},
"meta": {
"requestId": "4f849d7d-f4f1-45cc-b4b7-3984a3d17f83",
"rateLimit": {
"limit": 10,
"remaining": 9,
"resetSeconds": 1
}
}
}Get the full paginated weekly ranking (leaderboard)
The full paginated ‘Your ranking this week’ list (the ‘See all’ screen behind the compact weeklyRanking card on the client Training page). Response shape mirrors the WOD leaderboard: podium[] (full top-3 rows), data[] (paginated slice starting at rank 4 — the podium is excluded and never repeated), currentUser (the client’s own row, ALWAYS returned and pinned statically — e.g. rank 200 stays fixed while data scrolls; carries the ‘XP to next rank’ progress), avatars (compact top-3 strip), totalCount, othersCount, pagination (counts participants excluding the podium). Page size defaults to 10. Self-gated by the leaderboard config (enabled + weeklyLeaderboardEnabled) and the client’s visibility. Pass weekStart=YYYY-MM-DD to view a closed past week (e.g. from the weekly leaderboard_position notification); without it the current week is returned as before. Past weeks return isCurrentWeek: false and resetLabel: null. Anonymity (applied to data, avatars, and currentUser): company anonymousMode: 'names' masks other members’ names to ‘Member #rank’ (image kept); 'names_and_profiles' also drops the image (anonymousAvatar: true); a personally-anonymous member becomes ‘Anonymous’ with no image. Company modes never mask the current user, but their own personal anonymity does (‘Anonymous (You)’).
Requires the workout_progress:read scope and the corresponding Workout features and permissions.
The clientId path parameter identifies a client in the company bound to the Public API token.
curl -X GET "https://api.fitsociety.io/public/v1/workout/clients/{clientId}/weekly-ranking" \
-H "Authorization: Bearer <access_token>"const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.fitsociety.io/public/v1/workout/clients/{clientId}/weekly-ranking', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.fitsociety.io/public/v1/workout/clients/{clientId}/weekly-ranking"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"data": {
"enabled": true,
"hidden": false,
"isCurrentWeek": true,
"resetLabel": "Reset in 4 days - Sunday Midnight",
"weekStart": "2026-07-12T00:00:00.000Z",
"weekEnd": "2026-07-19T00:00:00.000Z",
"podium": [
{
"rank": 4,
"clientId": "67f1234567890abcdef1234",
"firstName": "Kaylynn",
"lastName": "Lubin",
"name": "Kaylynn Lubin",
"image": "https://cdn.example.com/4.jpg",
"xp": 3895,
"trend": "up",
"anonymousAvatar": false,
"isCurrentUser": false
}
],
"data": [
{
"rank": 4,
"clientId": "67f1234567890abcdef1234",
"firstName": "Kaylynn",
"lastName": "Lubin",
"name": "Kaylynn Lubin",
"image": "https://cdn.example.com/4.jpg",
"xp": 3895,
"trend": "up",
"anonymousAvatar": false,
"isCurrentUser": false
}
],
"currentUser": {
"rank": 200,
"clientId": "67f1234567890abcdef1234",
"firstName": "Wilson",
"lastName": "Calzoni",
"name": "Wilson Calzoni",
"image": "https://cdn.example.com/you.jpg",
"anonymousAvatar": false,
"xp": 320,
"trend": "down",
"nextRank": 199,
"nextRankValue": 340,
"xpToNextRank": 20,
"progressToNextRank": 0.94,
"participating": true,
"inCurrentPage": false,
"isCurrentUser": true
},
"avatars": [
{
"clientId": "67f1234567890abcdef1234",
"image": "https://cdn.example.com/clients/a1.jpg",
"name": "Bryan Wolf"
}
],
"totalCount": 213,
"othersCount": 210,
"pagination": {
"page": 1,
"limit": 10,
"totalPages": 16,
"totalItems": 153,
"hasNextPage": true,
"hasPreviousPage": false,
"nextPage": 2,
"previousPage": false,
"totalAvailableItems": 1
},
"availableFilters": {
"gender": [
{
"key": "male",
"label": "Male"
},
{
"key": "female",
"label": "Female"
},
{
"key": "prefer_not_to_say",
"label": "Prefer not to say"
}
],
"scoringType": [
{
"key": "standard",
"label": "Standard"
},
{
"key": "forTime",
"label": "For Time"
},
{
"key": "amrap",
"label": "AMRAP"
},
{
"key": "emom",
"label": "EMOM"
},
{
"key": "tabata",
"label": "Tabata"
},
{
"key": "maxLoad",
"label": "Max Load"
}
],
"allowedDivisions": [
{
"key": "rx",
"label": "RX"
},
{
"key": "scaled",
"label": "Scaled"
},
{
"key": "rx_scaled",
"label": "RX & Scaled"
}
]
},
"selectedFilters": {
"gender": "female",
"scoringType": "maxLoad",
"allowedDivisions": null
}
},
"meta": {
"requestId": "4f849d7d-f4f1-45cc-b4b7-3984a3d17f83",
"rateLimit": {
"limit": 10,
"remaining": 9,
"resetSeconds": 1
}
}
}Authorizations
Path Parameters
Query Parameters
Show a past week instead of the current one: any date inside that week (YYYY-MM-DD), normalised to its Sunday 00:00 UTC start. Omit for the current week (unchanged behaviour). The leaderboard_position notification's action.data.weekStart can be passed as-is. A date in a future week returns 400 LEADERBOARD_WEEK_START_INVALID.
"2026-10-04"
Show only members of this gender. prefer_not_to_say includes members without a stated gender and members who chose 'Other'. Omit, leave empty or pass all for everyone. The response shape is unchanged: ranks, podium, data, currentUser, totalCount and pagination are all computed within the filtered board, and currentUser is empty when the client is outside the filter. Any other value returns 400 LEADERBOARD_FILTER_INVALID.
male, female, prefer_not_to_say, all "female"
Rank by the XP earned only from WODs with this scoring type in the week, so xp, ranks and the podium reflect those WODs alone. A WOD set to standard uses the scoring type of its planned workout. Members without XP from matching WODs are not listed. Omit or pass all for total weekly XP. Combines with gender and allowedDivisions. Any other value returns 400 LEADERBOARD_FILTER_INVALID.
standard, forTime, amrap, emom, tabata, maxLoad, all "maxLoad"
Rank by the XP earned only from WODs whose allowed divisions are exactly this set: rx (RX only), scaled (Scaled only) or rx_scaled (both). It filters on the WOD setting, not on the division a member chose. Omit or pass all for total weekly XP. Combines with gender and scoringType. Any other value returns 400 LEADERBOARD_FILTER_INVALID.
rx, scaled, rx_scaled, all "rx_scaled"