---
title: "Get match by id"
method: GET
path: "/hockey/matches/{id}"
tags: ["Hockey.Matches"]
---

# Get match by id

`GET /hockey/matches/{id}`

## Request

- Base URL: `https://sports.highlightly.net`
- URL: `https://sports.highlightly.net/hockey/matches/{id}`
- Auth: none declared. Required headers: `x-rapidapi-host`, `x-rapidapi-key`
- TypeScript: <https://skmtc.dev/highlightly/apis/sports-api-highlightly/docs/hockey/matches/:id/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieve detailed match information by specifying the match id path parameter.

Certain popular leagues and their associated matches will have additional data about the `venue` and match weather `forecast`.
 
> Note: Used to retrieve additional match information.

## Path parameters

- `id` number, required

## Headers

- `x-rapidapi-host` string, required
- `x-rapidapi-key` string, required

## Response `200`

- HockeyDetailedMatchResponseDto[]
  - `id` number, required
  - `week` string
  - `date` string, required
  - `country` HockeyCountryResponseDto, required
    - `code` string, required: Country code specified by the ISO 3166 standard.
    - `name` string, required
    - `logo` string, required
  - `awayTeam` HockeyTeamResponseDto, required
    - `id` number, required
    - `logo` string
    - `name` string, required
  - `homeTeam` HockeyTeamResponseDto, required
    - `id` number, required
    - `logo` string
    - `name` string, required
  - `league` HockeyMatchLeagueResponseDto, required
    - `id` number, required
    - `season` number, required
    - `name` string, required
    - `logo` string
  - `state` HockeyMatchStateResponseDto, required
    - `description` 'Not started' | '1st period' | '2nd period' | '3rd period' | 'Over time' | 'Penalties' | 'Break time' | 'Awarded' | 'Postponed' | 'Cancelled' | 'Interrupted' | 'Abandoned' | 'Finished' | 'To be announced' | 'Finished after penalties' | 'Finished after over time' | 'Unknown', required: Current state of the game.
    - `score` HockeyMatchScoreResponseDto, required
      - `current` string: Home - Away score for the match.
      - `overTime` string: Home - Away score in overtime.
      - `penalties` string: Home - Away score in penalties.
      - `firstPeriod` string: Home - Away score in 1st period.
      - `secondPeriod` string: Home - Away score in 2nd period.
      - `thirdPeriod` string: Home - Away score in 3rd period.
  - `venue` DetailedMatchVenueResponseDto
    - `city` string
    - `name` string
    - `country` string
    - `capacity` string
  - `referee` DetailedMatchRefereeResponseDto
    - `name` string
    - `nationality` string
  - `forecast` DetailedMatchForecastResponseDto
    - `status` string
    - `temperature` string
  - `predictions` PredictionResponseDto
    - `prematch` PredictionDto[], required
      - `type` string, required
      - `modelType` string, required
      - `generatedAt` string, required
      - `description` string, required
      - `probabilities` PredictionProbabilitiesDto, required
        - `home` string, required
        - `draw` string
        - `away` string, required
    - `live` PredictionDto[], required
      - `type` string, required
      - `modelType` string, required
      - `generatedAt` string, required
      - `description` string, required
      - `probabilities` PredictionProbabilitiesDto, required
        - `home` string, required
        - `draw` string
        - `away` string, required

## Other responses

- `400`: Bad request descriptive error.
- `500`: Internal server error.

---

[API](https://skmtc.dev/highlightly/apis/sports-api-highlightly.md) - [All operations](https://skmtc.dev/highlightly/apis/sports-api-highlightly/llms.txt) - [OpenAPI document](https://skmtc.dev/highlightly/apis/sports-api-highlightly/revisions/c8a366d3091f?raw)