---
title: "loadEntries(for:timeScope:completionHandler:)"
framework: gamekit
role: symbol
role_heading: Instance Method
path: "gamekit/gkleaderboard/loadentries(for:timescope:completionhandler:)"
---

# loadEntries(for:timeScope:completionHandler:)

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

## Declaration

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

```swift
func loadEntries(for players: [GKPlayer], timeScope: GKLeaderboard.TimeScope) async throws -> (GKLeaderboard.Entry?, [GKLeaderboard.Entry])
```

## 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 doc://com.apple.gamekit/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:

## Mentioned in

Connecting players with their friends in your game

## See Also

### Loading Scores

- [loadEntries(for:timeScope:range:completionHandler:)](gamekit/gkleaderboard/loadentries(for:timescope:range:completionhandler:).md)
- [GKLeaderboard.PlayerScope](gamekit/gkleaderboard/playerscope-swift.enum.md)
- [GKLeaderboard.TimeScope](gamekit/gkleaderboard/timescope-swift.enum.md)
- [GKLeaderboard.Entry](gamekit/gkleaderboard/entry.md)