<!--
{
  "availability" : [
    "iOS: 14.0.0 -",
    "iPadOS: 14.0.0 -",
    "macCatalyst: 14.0.0 -",
    "macOS: 11.0.0 -",
    "tvOS: 14.0.0 -",
    "visionOS: 1.0.0 -",
    "watchOS: 7.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "GameKit",
  "identifier" : "/documentation/GameKit/GKLeaderboard/loadEntries(for:timeScope:completionHandler:)",
  "metadataVersion" : "0.1.0",
  "role" : "Instance Method",
  "symbol" : {
    "kind" : "Instance Method",
    "modules" : [
      "GameKit"
    ],
    "preciseIdentifier" : "c:objc(cs)GKLeaderboard(im)loadEntriesForPlayers:timeScope:completionHandler:"
  },
  "title" : "loadEntries(for:timeScope:completionHandler:)"
}
-->

# loadEntries(for:timeScope:completionHandler:)

Returns the scores for the local player and other players for the specified time period.

```
func loadEntries(for players: [GKPlayer], timeScope: GKLeaderboard.TimeScope, completionHandler: @escaping @Sendable (GKLeaderboard.Entry?, [GKLeaderboard.Entry]?, (any Error)?) -> Void)
```

## Parameters

`players`

The players whose scores this method returns.

`timeScope`

Specifies the time period for the scores. This parameter is applicable to nonrecurring leaderboards only. For recurring leaderboards, pass [`GKLeaderboard.TimeScope.allTime`](/documentation/GameKit/GKLeaderboard/TimeScope-swift.enum/allTime) for this parameter.

`completionHandler`

A block that GameKit calls when this method loads the scores.

    The block receives the following parameters:

- localPlayerEntry: The score for the local player, or `nil` if the player has no score.
- entries: The scores for the players during the specified time period, including the local player’s score if it exists.
- error: Describes an error if it occurs, or `nil` if the operation completes.

## Discussion

---

Copyright &copy; 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)