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

# Testing

Test matchmaking rules using sample data.

## Discussion

Use the Testing APIs to apply matchmaking rules to sample match requests and player properties. For more information, see <doc://com.apple.documentation/documentation/GameKit/testing-matchmaking-rules>.

## Topics

### Applying rule sets to sample requests

[`Test a Rule Set`](/documentation/AppStoreConnectAPI/POST-v1-gameCenterMatchmakingRuleSetTests)

Apply the given rule set to the given sample match requests.

### Objects

[`object GameCenterMatchmakingRuleSetTestCreateRequest`](/documentation/AppStoreConnectAPI/GameCenterMatchmakingRuleSetTestCreateRequest)

The request body for testing the rules in a rule set.

[`object GameCenterMatchmakingTestRequest`](/documentation/AppStoreConnectAPI/GameCenterMatchmakingTestRequest)

The type and ID of test matchmaking request.

[`object GameCenterMatchmakingRuleSetTestResponse`](/documentation/AppStoreConnectAPI/GameCenterMatchmakingRuleSetTestResponse)

The response body for testing a rule set.

[`object GameCenterMatchmakingRuleSetTest`](/documentation/AppStoreConnectAPI/GameCenterMatchmakingRuleSetTest)

A test run of a Game Center matchmaking rule set using simulated player properties to validate the rules.

[`object GameCenterMatchmakingTestRequestInlineCreate`](/documentation/AppStoreConnectAPI/GameCenterMatchmakingTestRequestInlineCreate)

A data structure that represents a sample match request for testing a rule set.

[`object GameCenterMatchmakingTestPlayerProperty`](/documentation/AppStoreConnectAPI/GameCenterMatchmakingTestPlayerProperty)

A simulated player attribute used when testing Game Center matchmaking rule sets.

[`object GameCenterMatchmakingTestPlayerPropertyInlineCreate`](/documentation/AppStoreConnectAPI/GameCenterMatchmakingTestPlayerPropertyInlineCreate)

A resource object that represents a player’s properties when you create a request.

[`object GameCenterMatchmakingTeamAssignment`](/documentation/AppStoreConnectAPI/GameCenterMatchmakingTeamAssignment)

The assignment of a player to a specific team during a Game Center matchmaking session.

[`object Location`](/documentation/AppStoreConnectAPI/Location)

A representation of a device location.

[`object Property`](/documentation/AppStoreConnectAPI/Property)

A representation of a game-specific property.


---

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)