StartMatchmakingInput is a JSON Structure definition published by Amazon GameLift, describing 3 properties, of which 2 are required. It conforms to the https://json-structure.org/meta/core/v0/# meta-schema.
{
"$schema": "https://json-structure.org/meta/core/v0/#",
"$id": "https://raw.githubusercontent.com/api-evangelist/amazon-gamelift/refs/heads/main/json-structure/gamelift-start-matchmaking-input-structure.json",
"name": "StartMatchmakingInput",
"description": "StartMatchmakingInput schema from Amazon GameLift API",
"type": "object",
"properties": {
"TicketId": {
"allOf": [
{
"$ref": "#/components/schemas/MatchmakingIdStringModel"
},
{
"description": "A unique identifier for a matchmaking ticket. If no ticket ID is specified here, Amazon GameLift will generate one in the form of a UUID. Use this identifier to track the matchmaking ticket status and retrieve match results."
}
]
},
"ConfigurationName": {
"allOf": [
{
"$ref": "#/components/schemas/MatchmakingConfigurationName"
},
{
"description": "Name of the matchmaking configuration to use for this request. Matchmaking configurations must exist in the same Region as this request. You can use either the configuration name or ARN value."
}
]
},
"Players": {
"allOf": [
{
"$ref": "#/components/schemas/PlayerList"
},
{
"description": "<p>Information on each player to be matched. This information must include a player ID, and may contain player attributes and latency data to be used in the matchmaking process. After a successful match, <code>Player</code> objects contain the name of the team the player is assigned to.</p> <p>You can include up to 10 <code>Players</code> in a <code>StartMatchmaking</code> request.</p>"
}
]
}
},
"required": [
"ConfigurationName",
"Players"
]
}
Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we
store it to create your key and to recognise you if you sign in with another
provider. See our Privacy Policy and
Terms.