---
title: "Halo 5 - Player Match History"
method: GET
path: "/h5/players/{player}/matches"
---

# Halo 5 - Player Match History

`GET /h5/players/{player}/matches`

Retrieves a list of Matches that the Player has participated in and which have completed processing. If the Player is currently in a match, it is not returned in this API.

This endpoint will include games played on Local Servers with the Custom Local Game Mode for games that occurred or after December 22, 2017.

  

#### Changelog

**February 1, 2019:**

*   Enabled support for viewing the time component of the "MatchCompletedDate" via the "{include-times}" Request Parameter.

**December 22, 2017:**

*   Added support for the Custom Local Game mode.

**February 21, 2017:**

*   Renamed Endpoint from "Matches for Player" to "Halo 5 - Player Match History".
*   Removed "{title}" Request Parameter.

**April 20, 2016:**

*   Clarified documentation for the "MapVariant" and "GameVariant" fields.
*   Corrected "OwnerType" values for the "MapVariant" and "GameVariant" fields.

## Path parameters

- `player` string, required

## Query parameters

- `modes` string
- `start` number
- `count` number
- `include-times` boolean

## Response `200`

The response body will contain the Player's recent Matches. An empty list will be returned if the Player has not played any Matches in the specified Game Mode(s).

## Other responses

- `400` — An unsupported value was provided for a query string parameter.
- `404` — Specified Player was not found.
- `500` — Internal Server Error
- `503` — Service Unavailable

---

[API](https://skmtc.net/haloapi/apis/stats.md) · [All operations](https://skmtc.net/haloapi/apis/stats/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/haloapi/stats/versions/401e9a7e976b/schema)