---
title: "Halo 5 - Match Events"
method: GET
path: "/h5/matches/{matchId}/events"
---

# Halo 5 - Match Events

`GET /h5/matches/{matchId}/events`

Retrieves a set of Events related to the Match specified. Events are only available once the Match has completed.

The set of Events may grow over time as data becomes available.

This Endpoint does not have the accuracy guarantees of other Endpoints have, so please use with caution. This endpoint may not return Matches before December 1, 2015.

  

#### Changelog

**February 21, 2017:**

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

**May 20, 2016:**

*   The Endpoint now correctly reports the "Content-Type" Response Header as "application/json".

**May 16, 2016:**

*   Documented HTTP 503 Response Code.

**April 20, 2016:**

*   Added new types of events to the Endpoint: Impulses, Medals, Player Spawns, Round Stats, Round Ends, Weapon Drops, Weapon Pickups, and Weapon Pickup Pads.
*   Fixed an issue that caused the API to consistently return HTTP 500's for matches where a player left and rejoined the match.

## Path parameters

- `matchId` string, required

## Response `200`

The response body will contain the Match Events.

## Other responses

- `404` — The specified Match could not be 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)