List Matchmaking Queues
SDK support is limited to C# and Java for this API. List all matchmaking queue configs.
POST
/
Match
/
ListMatchmakingQueues
List Matchmaking Queues
curl --request POST \
--url https://{titleId}.playfabapi.com/Match/ListMatchmakingQueues \
--header 'Content-Type: application/json' \
--header 'X-EntityToken: <api-key>' \
--data '{}'import requests
url = "https://{titleId}.playfabapi.com/Match/ListMatchmakingQueues"
payload = {}
headers = {
"X-EntityToken": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'X-EntityToken': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({})
};
fetch('https://{titleId}.playfabapi.com/Match/ListMatchmakingQueues', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://{titleId}.playfabapi.com/Match/ListMatchmakingQueues",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-EntityToken: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://{titleId}.playfabapi.com/Match/ListMatchmakingQueues"
payload := strings.NewReader("{}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-EntityToken", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://{titleId}.playfabapi.com/Match/ListMatchmakingQueues")
.header("X-EntityToken", "<api-key>")
.header("Content-Type", "application/json")
.body("{}")
.asString();require 'uri'
require 'net/http'
url = URI("https://{titleId}.playfabapi.com/Match/ListMatchmakingQueues")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-EntityToken"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{}"
response = http.request(request)
puts response.read_body{
"code": 123,
"status": "<string>",
"data": {
"MatchMakingQueues": [
{
"Name": "ExampleQueueName",
"MinMatchSize": 7,
"MaxMatchSize": 8,
"MaxTicketSize": 2,
"ServerAllocationEnabled": true,
"BuildId": "065a3208-39af-4691-8794-5f774c367ac2",
"DifferenceRules": [
{
"Difference": 10,
"MergeFunction": "Average",
"DefaultAttributeValue": 0,
"LinearExpansion": {
"Delta": 0.5,
"Limit": 20,
"SecondsBetweenExpansions": 5
},
"Attribute": {
"Path": "ExampleAttributeDifference"
},
"Weight": 1,
"Name": "ExampleNameDifference",
"SecondsUntilOptional": 50
}
],
"StringEqualityRules": [
{
"DefaultAttributeValue": "ExampleDefault",
"Expansion": {
"EnabledOverrides": [
false,
true,
true,
false
],
"SecondsBetweenExpansions": 5
},
"Attribute": {
"Path": "ExampleAttributeStringEquality"
},
"Weight": 1,
"Name": "ExampleNameStringEquality",
"SecondsUntilOptional": 50
}
],
"MatchTotalRules": [
{
"Attribute": {
"Path": "ExampleAttribute"
},
"Min": 2,
"Weight": 1,
"Expansion": {
"MaxOverrides": [
{
"Value": 4
},
{
"Value": 4
},
null
],
"SecondsBetweenExpansions": 5
},
"Name": "MatchTotalRule",
"SecondsUntilOptional": 50
}
],
"SetIntersectionRules": [
{
"DefaultAttributeValue": [
"a",
"b",
"c"
],
"MinIntersectionSize": 2,
"LinearExpansion": {
"Delta": 2,
"SecondsBetweenExpansions": 5
},
"Attribute": {
"Path": "ExampleAttributeSetIntersectionRule"
},
"Weight": 1,
"Name": "ExampleNameSetIntersectionRule",
"SecondsUntilOptional": 50
}
],
"RegionSelectionRule": {
"MaxLatency": 250,
"Path": "Latencies",
"LinearExpansion": {
"Delta": 10,
"Limit": 300,
"SecondsBetweenExpansions": 5
},
"Weight": 1,
"Name": "RegionSelectionRule",
"SecondsUntilOptional": 50
},
"TeamSizeBalanceRule": {
"Difference": 1,
"LinearExpansion": {
"Delta": 1,
"Limit": 5,
"SecondsBetweenExpansions": 5
},
"Name": "TeamSizeBalanceRule",
"SecondsUntilOptional": 50
},
"TeamDifferenceRules": [
{
"Attribute": {
"Path": "ExampleAttribute"
},
"Difference": 2,
"LinearExpansion": {
"Delta": 1,
"Limit": 5,
"SecondsBetweenExpansions": 5
},
"Name": "TeamDifferenceRule",
"SecondsUntilOptional": 50
}
],
"TeamTicketSizeSimilarityRule": {
"Name": "TeamTicketSizeSimilarityRule",
"SecondsUntilOptional": 180
},
"Teams": [
{
"Name": "monster",
"MinTeamSize": 1,
"MaxTeamSize": 1
},
{
"Name": "hunters",
"MinTeamSize": 4,
"MaxTeamSize": 8
}
],
"StatisticsVisibilityToPlayers": {
"ShowNumberOfPlayersMatching": true,
"ShowTimeToMatch": true
}
}
]
}
}{
"code": 123,
"errorCode": 123,
"status": "<string>",
"error": "<string>",
"errorMessage": "<string>",
"errorDetails": {}
}Authorizations
This API requires an Entity Session Token, available from the Entity GetEntityToken method.
Body
application/json
Gets a list of all the matchmaking queue configurations for the title.
Gets a list of all the matchmaking queue configurations for the title.
The optional custom tags associated with the request (e.g. build number, external trace identifiers, etc.).
Last modified on October 1, 2026
Was this page helpful?
⌘I
List Matchmaking Queues
curl --request POST \
--url https://{titleId}.playfabapi.com/Match/ListMatchmakingQueues \
--header 'Content-Type: application/json' \
--header 'X-EntityToken: <api-key>' \
--data '{}'import requests
url = "https://{titleId}.playfabapi.com/Match/ListMatchmakingQueues"
payload = {}
headers = {
"X-EntityToken": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'X-EntityToken': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({})
};
fetch('https://{titleId}.playfabapi.com/Match/ListMatchmakingQueues', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://{titleId}.playfabapi.com/Match/ListMatchmakingQueues",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-EntityToken: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://{titleId}.playfabapi.com/Match/ListMatchmakingQueues"
payload := strings.NewReader("{}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-EntityToken", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://{titleId}.playfabapi.com/Match/ListMatchmakingQueues")
.header("X-EntityToken", "<api-key>")
.header("Content-Type", "application/json")
.body("{}")
.asString();require 'uri'
require 'net/http'
url = URI("https://{titleId}.playfabapi.com/Match/ListMatchmakingQueues")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-EntityToken"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{}"
response = http.request(request)
puts response.read_body{
"code": 123,
"status": "<string>",
"data": {
"MatchMakingQueues": [
{
"Name": "ExampleQueueName",
"MinMatchSize": 7,
"MaxMatchSize": 8,
"MaxTicketSize": 2,
"ServerAllocationEnabled": true,
"BuildId": "065a3208-39af-4691-8794-5f774c367ac2",
"DifferenceRules": [
{
"Difference": 10,
"MergeFunction": "Average",
"DefaultAttributeValue": 0,
"LinearExpansion": {
"Delta": 0.5,
"Limit": 20,
"SecondsBetweenExpansions": 5
},
"Attribute": {
"Path": "ExampleAttributeDifference"
},
"Weight": 1,
"Name": "ExampleNameDifference",
"SecondsUntilOptional": 50
}
],
"StringEqualityRules": [
{
"DefaultAttributeValue": "ExampleDefault",
"Expansion": {
"EnabledOverrides": [
false,
true,
true,
false
],
"SecondsBetweenExpansions": 5
},
"Attribute": {
"Path": "ExampleAttributeStringEquality"
},
"Weight": 1,
"Name": "ExampleNameStringEquality",
"SecondsUntilOptional": 50
}
],
"MatchTotalRules": [
{
"Attribute": {
"Path": "ExampleAttribute"
},
"Min": 2,
"Weight": 1,
"Expansion": {
"MaxOverrides": [
{
"Value": 4
},
{
"Value": 4
},
null
],
"SecondsBetweenExpansions": 5
},
"Name": "MatchTotalRule",
"SecondsUntilOptional": 50
}
],
"SetIntersectionRules": [
{
"DefaultAttributeValue": [
"a",
"b",
"c"
],
"MinIntersectionSize": 2,
"LinearExpansion": {
"Delta": 2,
"SecondsBetweenExpansions": 5
},
"Attribute": {
"Path": "ExampleAttributeSetIntersectionRule"
},
"Weight": 1,
"Name": "ExampleNameSetIntersectionRule",
"SecondsUntilOptional": 50
}
],
"RegionSelectionRule": {
"MaxLatency": 250,
"Path": "Latencies",
"LinearExpansion": {
"Delta": 10,
"Limit": 300,
"SecondsBetweenExpansions": 5
},
"Weight": 1,
"Name": "RegionSelectionRule",
"SecondsUntilOptional": 50
},
"TeamSizeBalanceRule": {
"Difference": 1,
"LinearExpansion": {
"Delta": 1,
"Limit": 5,
"SecondsBetweenExpansions": 5
},
"Name": "TeamSizeBalanceRule",
"SecondsUntilOptional": 50
},
"TeamDifferenceRules": [
{
"Attribute": {
"Path": "ExampleAttribute"
},
"Difference": 2,
"LinearExpansion": {
"Delta": 1,
"Limit": 5,
"SecondsBetweenExpansions": 5
},
"Name": "TeamDifferenceRule",
"SecondsUntilOptional": 50
}
],
"TeamTicketSizeSimilarityRule": {
"Name": "TeamTicketSizeSimilarityRule",
"SecondsUntilOptional": 180
},
"Teams": [
{
"Name": "monster",
"MinTeamSize": 1,
"MaxTeamSize": 1
},
{
"Name": "hunters",
"MinTeamSize": 4,
"MaxTeamSize": 8
}
],
"StatisticsVisibilityToPlayers": {
"ShowNumberOfPlayersMatching": true,
"ShowTimeToMatch": true
}
}
]
}
}{
"code": 123,
"errorCode": 123,
"status": "<string>",
"error": "<string>",
"errorMessage": "<string>",
"errorDetails": {}
}