---
title: "load(withID:withCompletionHandler:)"
framework: gamekit
role: symbol
role_heading: Type Method
path: "gamekit/gkturnbasedmatch/load(withid:withcompletionhandler:)"
---

# load(withID:withCompletionHandler:)

Loads a specific match with the specified identifier.

## Declaration

```swift
class func load(withID matchID: String, withCompletionHandler completionHandler: (@Sendable (GKTurnBasedMatch?, (any Error)?) -> Void)? = nil)
```

```swift
class func load(withID matchID: String) async throws -> GKTurnBasedMatch
```

## Parameters

- `matchID`: The identifier for the turn-based match.
- `completionHandler`: The block that GameKit calls when it completes the request. The block receives the following parameters:

## Discussion

Discussion The matchData property of the match object is nil until you fetch the data from Game Center using the loadMatchData(completionHandler:) method.

## See Also

### Loading Existing Matches

- [loadMatches(completionHandler:)](gamekit/gkturnbasedmatch/loadmatches(completionhandler:).md)