# Game Center leaderboards Create and manage leaderboards for your apps. ## Discussion Use leaderboards in your games so players can compare their scores against other players in the same game. When you configure leaderboards in App Store Connect, you specify details such as the scores to collect and how to order them. For more information about how to use leaderboards in your app, see [Configure leaderboards](https://developer.apple.com/help/app-store-connect/configure-game-center/configure-leaderboards/). ## Topics ### Reading leaderboards [`GET /v2/gameCenterLeaderboards/{id}`](/documentation/AppStoreConnectAPI/GET-v2-gameCenterLeaderboards-_id_) Get information about a specific Game Center leaderboard. [`GET /v2/gameCenterLeaderboards/{id}/versions`](/documentation/AppStoreConnectAPI/GET-v2-gameCenterLeaderboards-_id_-versions) Get a list of versions for a specific Game Center leaderboard. [`GET /v2/gameCenterLeaderboards/{id}/relationships/versions`](/documentation/AppStoreConnectAPI/GET-v2-gameCenterLeaderboards-_id_-relationships-versions) Get a list of version resource IDs for a specific Game Center leaderboard. [`GET /v1/gameCenterLeaderboards/{id}`](/documentation/AppStoreConnectAPI/GET-v1-gameCenterLeaderboards-_id_) Read information about a specific leaderboard. [`GET /v1/gameCenterLeaderboards/{id}/groupLeaderboard`](/documentation/AppStoreConnectAPI/GET-v1-gameCenterLeaderboards-_id_-groupLeaderboard) Read the group leadboard to which a leaderboard belongs. [`GET /v1/gameCenterLeaderboards/{id}/localizations`](/documentation/AppStoreConnectAPI/GET-v1-gameCenterLeaderboards-_id_-localizations) Get a list of localized metadata for a leaderboard. [`GET /v1/gameCenterLeaderboards/{id}/relationships/localizations`](/documentation/AppStoreConnectAPI/GET-v1-gameCenterLeaderboards-_id_-relationships-localizations) [`GET /v1/gameCenterLeaderboards/{id}/relationships/groupLeaderboard`](/documentation/AppStoreConnectAPI/GET-v1-gameCenterLeaderboards-_id_-relationships-groupLeaderboard) List associated group leaderboards for a specific leaderboard. [`GET /v1/gameCenterLeaderboards/{id}/releases`](/documentation/AppStoreConnectAPI/GET-v1-gameCenterLeaderboards-_id_-releases) Read the state of releases for a leaderboard and related information. [`GET /v1/gameCenterLeaderboards/{id}/relationships/releases`](/documentation/AppStoreConnectAPI/GET-v1-gameCenterLeaderboards-_id_-relationships-releases) ### Creating, modifying, and deleting leaderboards [`POST /v2/gameCenterLeaderboards`](/documentation/AppStoreConnectAPI/POST-v2-gameCenterLeaderboards) Create a Game Center leaderboard. [`PATCH /v2/gameCenterLeaderboards/{id}`](/documentation/AppStoreConnectAPI/PATCH-v2-gameCenterLeaderboards-_id_) Update a specific Game Center leaderboard. [`PATCH /v2/gameCenterLeaderboards/{id}/relationships/activity`](/documentation/AppStoreConnectAPI/PATCH-v2-gameCenterLeaderboards-_id_-relationships-activity) Update the activity relationship for a specific Game Center leaderboard. [`PATCH /v2/gameCenterLeaderboards/{id}/relationships/challenge`](/documentation/AppStoreConnectAPI/PATCH-v2-gameCenterLeaderboards-_id_-relationships-challenge) Update the challenge relationship for a specific Game Center leaderboard. [`DELETE /v2/gameCenterLeaderboards/{id}`](/documentation/AppStoreConnectAPI/DELETE-v2-gameCenterLeaderboards-_id_) Delete a specific Game Center leaderboard. [`POST /v1/gameCenterLeaderboards`](/documentation/AppStoreConnectAPI/POST-v1-gameCenterLeaderboards) Add a new leaderboard to your app. [`PATCH /v1/gameCenterLeaderboards/{id}`](/documentation/AppStoreConnectAPI/PATCH-v1-gameCenterLeaderboards-_id_) Modify the details of a leaderboard. [`PATCH /v1/gameCenterLeaderboards/{id}/relationships/groupLeaderboard`](/documentation/AppStoreConnectAPI/PATCH-v1-gameCenterLeaderboards-_id_-relationships-groupLeaderboard) Modify the group leadboard to which a leaderboard belongs. [`PATCH /v1/gameCenterLeaderboards/{id}/relationships/activity`](/documentation/AppStoreConnectAPI/PATCH-v1-gameCenterLeaderboards-_id_-relationships-activity) [`PATCH /v1/gameCenterLeaderboards/{id}/relationships/challenge`](/documentation/AppStoreConnectAPI/PATCH-v1-gameCenterLeaderboards-_id_-relationships-challenge) [`DELETE /v1/gameCenterLeaderboards/{id}`](/documentation/AppStoreConnectAPI/DELETE-v1-gameCenterLeaderboards-_id_) Delete a leaderboard from your app. ### Objects and types [`GameCenterLeaderboardV2`](/documentation/AppStoreConnectAPI/GameCenterLeaderboardV2) The data structure that represents a Game Center leaderboard v2 resource. [`GameCenterLeaderboardV2CreateRequest`](/documentation/AppStoreConnectAPI/GameCenterLeaderboardV2CreateRequest) The request body you use to create a Game Center leaderboard v2. [`GameCenterLeaderboardV2Response`](/documentation/AppStoreConnectAPI/GameCenterLeaderboardV2Response) A response that contains a single Game Center leaderboard v2 resource. [`GameCenterLeaderboardV2UpdateRequest`](/documentation/AppStoreConnectAPI/GameCenterLeaderboardV2UpdateRequest) The request body you use to update a Game Center leaderboard v2. [`GameCenterLeaderboardsV2Response`](/documentation/AppStoreConnectAPI/GameCenterLeaderboardsV2Response) A response that contains a list of Game Center leaderboard resources. [`GameCenterLeaderboardV2ActivityLinkageRequest`](/documentation/AppStoreConnectAPI/GameCenterLeaderboardV2ActivityLinkageRequest) The data structure that represents a Game Center leaderboard v2 activity linkage request resource. [`GameCenterLeaderboardV2ChallengeLinkageRequest`](/documentation/AppStoreConnectAPI/GameCenterLeaderboardV2ChallengeLinkageRequest) The data structure that represents a Game Center leaderboard v2 challenge linkage request resource. [`GameCenterLeaderboardV2VersionsLinkagesResponse`](/documentation/AppStoreConnectAPI/GameCenterLeaderboardV2VersionsLinkagesResponse) A response that contains a list of Game Center leaderboard v2 version linkage resources. [`GameCenterLeaderboardUpdateRequest`](/documentation/AppStoreConnectAPI/GameCenterLeaderboardUpdateRequest) The request body you use to update a leaderboard. [`GameCenterLeaderboardsResponse`](/documentation/AppStoreConnectAPI/GameCenterLeaderboardsResponse) The response body for endpoints that list Game Center leaderboards. [`GameCenterLeaderboard`](/documentation/AppStoreConnectAPI/GameCenterLeaderboard) The data structure that represent a leaderboard resource. [`GameCenterLeaderboardCreateRequest`](/documentation/AppStoreConnectAPI/GameCenterLeaderboardCreateRequest) The request body you use to create a leaderboard. [`GameCenterLeaderboardResponse`](/documentation/AppStoreConnectAPI/GameCenterLeaderboardResponse) The response body for endpoints that create, read, or modify a single Game Center leaderboard. [`GameCenterLeaderboardGroupLeaderboardLinkageRequest`](/documentation/AppStoreConnectAPI/GameCenterLeaderboardGroupLeaderboardLinkageRequest) The request body you use to attach an individual leaderbaord to a group leaderboard. [`GameCenterLeaderboardGroupLeaderboardLinkageResponse`](/documentation/AppStoreConnectAPI/GameCenterLeaderboardGroupLeaderboardLinkageResponse) A response confriming a relationship between a leaderboard and group leaderboard. [`GameCenterLeaderboardActivityLinkageRequest`](/documentation/AppStoreConnectAPI/GameCenterLeaderboardActivityLinkageRequest) [`GameCenterLeaderboardChallengeLinkageRequest`](/documentation/AppStoreConnectAPI/GameCenterLeaderboardChallengeLinkageRequest) [`GameCenterLeaderboardFormatter`](/documentation/AppStoreConnectAPI/GameCenterLeaderboardFormatter) The values you can select to describe the format of a leaderboard. [`StringToStringMap`](/documentation/AppStoreConnectAPI/StringToStringMap) A dictionary object mapping arbitrary string keys to string values, used for flexible key-value metadata. --- 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)