---
title: "report(completionHandler:)"
framework: gamekit
role: symbol
role_heading: Instance Method
path: "gamekit/gkachievement/report(completionhandler:)"
---

# report(completionHandler:)

Reports the player’s progress to Game Center.

## Declaration

```swift
func report(completionHandler: (@Sendable ((any Error)?) -> Void)? = nil)
```

```swift
func report() async throws
```

## Parameters

- `completionHandler`: A block to be called after the operation completes. The block takes the following parameter:

## Discussion

Discussion When the player makes progress towards completing an achievement, your game communicates the player’s progress to Game Center by calling this method. An achievement object is implicitly tied to the local player that was initialized when the object was created; your game should only report progress when the same local player is still on the device. note: To avoid using network bandwidth unnecessarily, only report an achievement when the player has made more progress towards completing it. When the progress is successfully reported, the achievement is made visible if it was previously hidden. The percentComplete and lastReportedDate property values stored on Game Center are updated if the new percentComplete value is greater than the value previously stored on Game Center. if the value of the percentComplete property was equal to 100.0, then the achievement is marked as completed and a banner may be shown to the player. When this method is called, it creates a new background task to handle the request. The method then returns control to your game. The background task automatically handles network errors, resending the data until the task completes. When the task is complete, Game Kit calls your completion handler. The completion handler is always called on the main thread.

## See Also

### Related Documentation

- [showsCompletionBanner](gamekit/gkachievement/showscompletionbanner.md)
- [isHidden](gamekit/gkachievement/ishidden.md)
- [isCompleted](gamekit/gkachievement/iscompleted.md)

### Deprecated Methods

- [issueChallenge(toPlayers:message:)](gamekit/gkachievement/issuechallenge(toplayers:message:).md)
- [selectChallengeablePlayerIDs(_:withCompletionHandler:)](gamekit/gkachievement/selectchallengeableplayerids(_:withcompletionhandler:).md)