# Match List Client systems can request a list of available scout matches for a specific time frame. **XML example** ```xml ``` ***XML attributes definition*** | Element | Attributes | Description | Possible Values | | --------- | ------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------- | | matchlist |


| | | | | *hoursback* | The amount of hours ago the timeframe for the request starts. | Integer | | | *hoursforward* | The amount of hours in the future the timeframe for the requests ends. | Integer | | | *includeavailable* | Optional attribute. If this attribute is passed and the value is "yes", the match list reply will also include matches that are not booked yet, but open for booking. |

String

yes = Include available matches

| {% hint style="info" %} **Note**\ The maximum timespan one can request matches for is 300 hours. If the timespan is greater than 300 hours it will automatically be adjusted down to 300 hours. If the optional attribute includeavailable="yes" is set, the maximum values of "hoursback" and "hoursforward" are 48 hours and 240 hours respectively. {% endhint %} {% hint style="info" %} **Note**\ The maximum timespan one can request matches for is 300 hours. If the timespan is greater than 300 hours it will automatically be adjusted down to 300 hours. If the optional attribute includeavailable="yes" is set, the maximum values of "hoursback" and "hoursforward" are 48 hours and 240 hours respectively. {% endhint %} **Match list reply**\ After the client system sends the match list request, a list of matches within the specified timeframe gets sent back. **XML example** ```xml ``` ***XML attributes definition***
ElementAttributesDescriptionPossible values
matchbookedOptional attribute indicating whether a match is booked or not. Only added if includeavailable=" yes" was added to the match list request.Integer
1 = Match is booked
0 = Match is not booked yet, but open
for booking.

vbpclassifcationAttribute to define Value Based pricing classification for customer packages.String
Values:
star
mvp

divisionDivision name associated with the team for US leagues/competition.
List of tournaments in scope attached.

String
**Match list filtering** To filter by sport id you can send for example: ```xml ``` ```xml ``` --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.sportradar.com/live-data/introduction/system-communication/xml-messages-sent-from-the-client-system/match-list.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.