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

# Get match by id

`GET /volleyball/matches/{id}`

## Request

- Base URL: `https://sports.highlightly.net`
- URL: `https://sports.highlightly.net/volleyball/matches/{id}`
- Auth: none declared. Required headers: `x-rapidapi-host`, `x-rapidapi-key`
- TypeScript: <https://skmtc.dev/highlightly/apis/sports-api-highlightly/docs/volleyball/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`

- VolleyballDetailedMatchResponseDto[]
  - `id` number, required
  - `week` string
  - `date` string, required
  - `country` VolleyballCountryResponseDto, required
    - `code` string, required: Country code specified by the ISO 3166 standard.
    - `name` string, required
    - `logo` string, required
  - `awayTeam` VolleyballTeamResponseDto, required
    - `id` number, required
    - `logo` string
    - `name` string, required
  - `homeTeam` VolleyballTeamResponseDto, required
    - `id` number, required
    - `logo` string
    - `name` string, required
  - `league` VolleyballMatchLeagueResponseDto, required
    - `id` number, required
    - `season` number, required
    - `name` string, required
    - `logo` string
  - `state` VolleyballMatchStateResponseDto, required
    - `description` 'Not started' | 'First set' | 'Second set' | 'Third set' | 'Fourth set' | 'Fifth set' | 'Awarded' | 'Postponed' | 'Cancelled' | 'Interrupted' | 'Abandoned' | 'Finished' | 'Unknown' | 'To be announced', required: State of the match.
    - `score` VolleyballMatchScoreResponseDto, required
      - `current` string: Home - Away score for the match.
      - `firstSet` string: Home - Away score for the first set.
      - `secondSet` string: Home - Away score for the second set.
      - `thirdSet` string: Home - Away score for the third set.
      - `fourthSet` string: Home - Away score for the fourth set.
      - `fifthSet` string: Home - Away score for the fifth set.
  - `venue` DetailedMatchVenueResponseDto
    - `city` string
    - `name` string
    - `country` string
    - `capacity` 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)