<!--
{
  "documentType" : "article",
  "framework" : "AppStoreConnectAPI",
  "identifier" : "/documentation/AppStoreConnectAPI/request",
  "metadataVersion" : "0.1.0",
  "role" : "article",
  "title" : "Request"
}
-->

# Request

An object that represents a match request in a queue.

## Discussion

Use a `Request` object in the expression of a matchmaking rule to access data in the matchmaking rules. A `Request` object corresponds to a <doc://com.apple.documentation/documentation/GameKit/GKMatchRequest> object that the game creates to submit a match request.

### Properties

-`appVersion`: The app version of the game that makes the request.
-`bundleId`: The bundle ID of the game that makes the request.
-`locale`: The language and region that the player who initiates this match request uses.
-`maxPlayer`: The maximum number of players that can join the match. This is the same value as the `GKMatchRequest.`<doc://com.apple.documentation/documentation/GameKit/GKMatchRequest/maxPlayers> property that you set when submitting this request.
-`minPlayers`: The minimum number of players that can join the match. This is the same value as the `GKMatchRequest.`<doc://com.apple.documentation/documentation/GameKit/GKMatchRequest/minPlayers> property that you set when submitting this request.
-`platform`: The platform of the game that makes the request.
-`playerCount`: The total number of players invited to join the match, including the player who initiates the match request. For example, if the request is for the local player only, the player count is `1`. If the local player invites one friend, the player count is `2`.
-`playerId`: A unique identifier for the player who initiates this match request.
-`properties`: The properties of the game or player that initiates this match request.
-`requestName`: A unique identifier for the request.
-`secondsInQueue`: The age of the request in seconds.

---

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)