# report(_:withCompletionHandler:) Reports a list of scores to Game Center ``` class func report(_ scores: [GKScore], withCompletionHandler completionHandler: (@Sendable ((any Error)?) -> Void)? = nil) ``` ## Parameters `scores` An array of scores to report to Game Center. `completionHandler` A block that GameKit calls when it reports the scores. The block receives the following parameter: - *error*: If an error occurred, this parameter holds an error object that describes the problem. If the score was successfully reported, this parameter’s value is `nil`. ## Discussion Use this class method whenever you need to submit scores to Game Center, whether you are reporting a single score or multiple scores. The method runs through the array of `GKScore` objects, submitting scores one at a time. [`report(_:withCompletionHandler:)`](/documentation/GameKit/GKScore/report(_:withCompletionHandler:)) provides a sample method to report a score. The `GKScore` object is initialized with the leaderboard ID for the leaderboard it reports its score to and then the [`value`](/documentation/GameKit/GKScore/value) and [`context`](/documentation/GameKit/GKScore/context) for the score are assigned. The leaderboard ID must be the identifier for a leaderboard you configured in App Store Connect. Scores are always reported for the current local player and never for friends. ```objc - (void) reportScore: (int64_t) score forLeaderboardID: (NSString*) identifier { GKScore *scoreReporter = [[GKScore alloc] initWithLeaderboardIdentifier: identifier]; scoreReporter.value = score; scoreReporter.context = 0; NSArray *scores = @[scoreReporter]; [GKScore reportScores:scores withCompletionHandler:^(NSError *error) { //Do something interesting here. }]; } ``` --- 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)