# Game Center leaderboard sets Manage Game Center leaderboard sets for your apps. ## Discussion Leaderboard sets organize several leaderboards into a single unit. For example, in a game that includes many levels, you might define a leaderboard set to organize the leaderboards for each level. A single app can have 100 leaderboard sets, and a set can have a maximum of 100 leaderboards. You must have at least one leaderboard for your app before you can create a leaderboard set. Once you add leaderboard sets to your app, all future leaderboards that you configure for the app must be included in a leaderboard set. The process to start using leaderboard sets to organize your app’s leaderboards includes these steps: - Create the first leaderboard set. - Create additional leaderboard sets. - Add new leaderboards directly into leaderboard sets. For more information about how to use Leaderboard sets in your app, see [Configure leaderboards sets](https://developer.apple.com/help/app-store-connect/configure-game-center/configure-leaderboard-sets). ## Topics ### Reading leaderboard sets [`GET /v2/gameCenterLeaderboardSets/{id}`](/documentation/AppStoreConnectAPI/GET-v2-gameCenterLeaderboardSets-_id_) Get information about a specific Game Center leaderboard set. [`GET /v2/gameCenterLeaderboardSets/{id}/gameCenterLeaderboards`](/documentation/AppStoreConnectAPI/GET-v2-gameCenterLeaderboardSets-_id_-gameCenterLeaderboards) Get a list of leaderboards for a specific Game Center leaderboard set. [`GET /v2/gameCenterLeaderboardSets/{id}/relationships/gameCenterLeaderboards`](/documentation/AppStoreConnectAPI/GET-v2-gameCenterLeaderboardSets-_id_-relationships-gameCenterLeaderboards) Get a list of leaderboard resource IDs for a specific Game Center leaderboard set. [`GET /v2/gameCenterLeaderboardSets/{id}/versions`](/documentation/AppStoreConnectAPI/GET-v2-gameCenterLeaderboardSets-_id_-versions) Get a list of versions for a specific Game Center leaderboard set. [`GET /v2/gameCenterLeaderboardSets/{id}/relationships/versions`](/documentation/AppStoreConnectAPI/GET-v2-gameCenterLeaderboardSets-_id_-relationships-versions) Get a list of version resource IDs for a specific Game Center leaderboard set. [`GET /v1/gameCenterLeaderboardSets/{id}`](/documentation/AppStoreConnectAPI/GET-v1-gameCenterLeaderboardSets-_id_) Read information about a specific leaderboard set. [`GET /v1/gameCenterLeaderboardSets/{id}/gameCenterLeaderboards`](/documentation/AppStoreConnectAPI/GET-v1-gameCenterLeaderboardSets-_id_-gameCenterLeaderboards) Read the leadboards that belong to a learderboard set. [`GET /v1/gameCenterLeaderboardSets/{id}/groupLeaderboardSet`](/documentation/AppStoreConnectAPI/GET-v1-gameCenterLeaderboardSets-_id_-groupLeaderboardSet) List information about leaderboards and leaderboard sets in a group leaderboard set. [`GET /v1/gameCenterLeaderboardSets/{id}/localizations`](/documentation/AppStoreConnectAPI/GET-v1-gameCenterLeaderboardSets-_id_-localizations) Get a list of localized metadata for a leaderboard set. [`GET /v1/gameCenterLeaderboardSets/{id}/relationships/localizations`](/documentation/AppStoreConnectAPI/GET-v1-gameCenterLeaderboardSets-_id_-relationships-localizations) [`GET /v1/gameCenterLeaderboardSets/{id}/relationships/gameCenterLeaderboards`](/documentation/AppStoreConnectAPI/GET-v1-gameCenterLeaderboardSets-_id_-relationships-gameCenterLeaderboards) List all leaderboards in a leaderboard set. [`GET /v1/gameCenterLeaderboardSets/{id}/relationships/groupLeaderboardSet`](/documentation/AppStoreConnectAPI/GET-v1-gameCenterLeaderboardSets-_id_-relationships-groupLeaderboardSet) List all the group leaderboard sets in a leaderboard set. [`GET /v1/gameCenterLeaderboardSets/{id}/releases`](/documentation/AppStoreConnectAPI/GET-v1-gameCenterLeaderboardSets-_id_-releases) Read the state of releases for a leaderboard set and related information. [`GET /v1/gameCenterLeaderboardSets/{id}/relationships/releases`](/documentation/AppStoreConnectAPI/GET-v1-gameCenterLeaderboardSets-_id_-relationships-releases) ### Creating, editing, and deleting leaderboard sets [`POST /v2/gameCenterLeaderboardSets`](/documentation/AppStoreConnectAPI/POST-v2-gameCenterLeaderboardSets) Create a Game Center leaderboard set. [`POST /v2/gameCenterLeaderboardSets/{id}/relationships/gameCenterLeaderboards`](/documentation/AppStoreConnectAPI/POST-v2-gameCenterLeaderboardSets-_id_-relationships-gameCenterLeaderboards) Add a leaderboard to a Game Center leaderboard set. [`PATCH /v2/gameCenterLeaderboardSets/{id}`](/documentation/AppStoreConnectAPI/PATCH-v2-gameCenterLeaderboardSets-_id_) Update a specific Game Center leaderboard set. [`PATCH /v2/gameCenterLeaderboardSets/{id}/relationships/gameCenterLeaderboards`](/documentation/AppStoreConnectAPI/PATCH-v2-gameCenterLeaderboardSets-_id_-relationships-gameCenterLeaderboards) Update the leaderboards relationship for a specific Game Center leaderboard set. [`DELETE /v2/gameCenterLeaderboardSets/{id}`](/documentation/AppStoreConnectAPI/DELETE-v2-gameCenterLeaderboardSets-_id_) Delete a specific Game Center leaderboard set. [`DELETE /v2/gameCenterLeaderboardSets/{id}/relationships/gameCenterLeaderboards`](/documentation/AppStoreConnectAPI/DELETE-v2-gameCenterLeaderboardSets-_id_-relationships-gameCenterLeaderboards) Delete a specific Game Center leaderboard set. [`POST /v1/gameCenterLeaderboardSets`](/documentation/AppStoreConnectAPI/POST-v1-gameCenterLeaderboardSets) Add a new leaderboard set to your app. [`POST /v1/gameCenterLeaderboardSets/{id}/relationships/gameCenterLeaderboards`](/documentation/AppStoreConnectAPI/POST-v1-gameCenterLeaderboardSets-_id_-relationships-gameCenterLeaderboards) Add a leaderboard to a leaderboard set. [`PATCH /v1/gameCenterLeaderboardSets/{id}`](/documentation/AppStoreConnectAPI/PATCH-v1-gameCenterLeaderboardSets-_id_) Modify the metadata for a leaderboard set. [`PATCH /v1/gameCenterLeaderboardSets/{id}/relationships/gameCenterLeaderboards`](/documentation/AppStoreConnectAPI/PATCH-v1-gameCenterLeaderboardSets-_id_-relationships-gameCenterLeaderboards) Edit the positions of leaderboards in an existing leaderboard set. [`PATCH /v1/gameCenterLeaderboardSets/{id}/relationships/groupLeaderboardSet`](/documentation/AppStoreConnectAPI/PATCH-v1-gameCenterLeaderboardSets-_id_-relationships-groupLeaderboardSet) Modify the group leaderboards in a leaderboard set. [`DELETE /v1/gameCenterLeaderboardSets/{id}`](/documentation/AppStoreConnectAPI/DELETE-v1-gameCenterLeaderboardSets-_id_) Delete a specific leaderboard set. [`DELETE /v1/gameCenterLeaderboardSets/{id}/relationships/gameCenterLeaderboards`](/documentation/AppStoreConnectAPI/DELETE-v1-gameCenterLeaderboardSets-_id_-relationships-gameCenterLeaderboards) Remove a leaderboard from a leaderboard set. ### Objects [`GameCenterLeaderboardSetV2`](/documentation/AppStoreConnectAPI/GameCenterLeaderboardSetV2) The data structure that represents a Game Center leaderboard set v2 resource. [`GameCenterLeaderboardSetV2CreateRequest`](/documentation/AppStoreConnectAPI/GameCenterLeaderboardSetV2CreateRequest) The request body you use to create a Game Center leaderboard set v2. [`GameCenterLeaderboardSetV2Response`](/documentation/AppStoreConnectAPI/GameCenterLeaderboardSetV2Response) A response that contains a single Game Center leaderboard set v2 resource. [`GameCenterLeaderboardSetV2UpdateRequest`](/documentation/AppStoreConnectAPI/GameCenterLeaderboardSetV2UpdateRequest) The request body you use to update a Game Center leaderboard set v2. [`GameCenterLeaderboardSetsV2Response`](/documentation/AppStoreConnectAPI/GameCenterLeaderboardSetsV2Response) A response that contains a single Game Center leaderboard set v2 resource. [`GameCenterLeaderboardSetV2GameCenterLeaderboardsLinkagesRequest`](/documentation/AppStoreConnectAPI/GameCenterLeaderboardSetV2GameCenterLeaderboardsLinkagesRequest) The data structure that represents a Game Center leaderboard set v2 Game Center leaderboard linkage request resource. [`GameCenterLeaderboardSetV2GameCenterLeaderboardsLinkagesResponse`](/documentation/AppStoreConnectAPI/GameCenterLeaderboardSetV2GameCenterLeaderboardsLinkagesResponse) A response that contains a list of Game Center leaderboard set v2 Game Center leaderboard linkage resources. [`GameCenterLeaderboardSetV2VersionsLinkagesResponse`](/documentation/AppStoreConnectAPI/GameCenterLeaderboardSetV2VersionsLinkagesResponse) A response that contains a list of Game Center leaderboard set v2 version linkage resources. [`GameCenterLeaderboardSet`](/documentation/AppStoreConnectAPI/GameCenterLeaderboardSet) The data structure that represent a leaderboard set resource. [`GameCenterLeaderboardSetCreateRequest`](/documentation/AppStoreConnectAPI/GameCenterLeaderboardSetCreateRequest) The request body you use to create a leaderboard set. [`GameCenterLeaderboardSetGameCenterLeaderboardsLinkagesRequest`](/documentation/AppStoreConnectAPI/GameCenterLeaderboardSetGameCenterLeaderboardsLinkagesRequest) The request body you use to create a relationship between a leaderboard set and a leaderboard. [`GameCenterLeaderboardSetGameCenterLeaderboardsLinkagesResponse`](/documentation/AppStoreConnectAPI/GameCenterLeaderboardSetGameCenterLeaderboardsLinkagesResponse) A response that confirms a relationship between a leaderboard set and a leaderboard. [`GameCenterLeaderboardSetGroupLeaderboardSetLinkageRequest`](/documentation/AppStoreConnectAPI/GameCenterLeaderboardSetGroupLeaderboardSetLinkageRequest) The request body you use to create a relationship between a leaderboard set and a group leaderboard set. [`GameCenterLeaderboardSetGroupLeaderboardSetLinkageResponse`](/documentation/AppStoreConnectAPI/GameCenterLeaderboardSetGroupLeaderboardSetLinkageResponse) A response that confirms a relationship between a leaderboard set and a group leaderboard set. [`GameCenterLeaderboardSetResponse`](/documentation/AppStoreConnectAPI/GameCenterLeaderboardSetResponse) The response body for endpoints that create, read, or modify a single Game Center leaderboard set. [`GameCenterLeaderboardSetUpdateRequest`](/documentation/AppStoreConnectAPI/GameCenterLeaderboardSetUpdateRequest) The request body you use to update a leaderboard set. [`GameCenterLeaderboardSetsResponse`](/documentation/AppStoreConnectAPI/GameCenterLeaderboardSetsResponse) The response body for endpoints that list Game Center leaderboard sets. [`GameCenterLeaderboardSetLocalizationGameCenterLeaderboardSetImageLinkageResponse`](/documentation/AppStoreConnectAPI/GameCenterLeaderboardSetLocalizationGameCenterLeaderboardSetImageLinkageResponse) [`GameCenterLeaderboardSetLocalizationsLinkagesResponse`](/documentation/AppStoreConnectAPI/GameCenterLeaderboardSetLocalizationsLinkagesResponse) --- Copyright © 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)