---
title: Get Rule-Based Match Requests
framework: appstoreconnectapi
role: symbol
role_heading: Web Service Endpoint
path: appstoreconnectapi/get-v1-gamecenterdetails-_id_-metrics-rulebasedmatchmakingrequests
---

# Get Rule-Based Match Requests

Get match requests that use matchmaking rules.

## URL

GET https://api.appstoreconnect.apple.com/v1/gameCenterDetails/{id}/metrics/ruleBasedMatchmakingRequests

## Path Parameters

id: An opaque resource ID that uniquely identifies the GameCenterDetail resource object. You can obtain this resource ID from the List apps response.

## Query Parameters

filter[result]: The types of the match requests to include in the response. granularity: The level of information you want in the response, specified as a time interval for the data collection, using the ISO 8601 format for durations. groupBy: If result, organizes the match requests by type (MATCHED, CANCELED, and EXPIRED). limit: The maximum number of match requests to fetch. sort: Sorts the match request by count or duration in the queue. For example, count sorts the results by decreasing number of players that Game Center finds.

## Response Codes

200 OK: 400 Bad Request: 401 Unauthorized: 403 Forbidden: 404 Not Found: 429 :

## Discussion

Discussion Example Request and Response

## See Also

### Getting match request metrics

- [Get Classic Match Requests](appstoreconnectapi/get-v1-gamecenterdetails-_id_-metrics-classicmatchmakingrequests.md)