---
title: "Get a match summary"
operationId: "GetMatchSummary"
method: GET
path: "/v2/matches/{matchId}/summary"
tag: "Match summary"
source: /openapi.json
---

# Get a match summary

```http
GET /v2/matches/{matchId}/summary
```

Return team-level match and period stats, score, clock, and period state for a match.

## Parameters

| Name | In | Required | Type | Description |
| --- | --- | --- | --- | --- |
| `matchId` | path | yes | `Id` | The match identifier |
| `lng` | query | no | `string` | Language code for period names (defaults to en) |

## Responses

| Status | Description | Body |
| --- | --- | --- |
| 200 | Ok | `MatchSummaryResponseV2` |
| 400 | Request is invalid | `ValidationError` |
| 401 | Missing or invalid api key | `AuthenticationError` |
| 403 | Api key provides insufficient access for the request | `AuthorizationError` |
| 404 | Match not found | `ResourceNotFound` |
| 429 | Api key has made too many requests | `RateLimitError` |
| 500 | An unexpected error has occured. If problems persist please contact support | `UnexpectedError` |

---

Generated from the OpenAPI specification at [/openapi.json](/openapi.json).