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

# Get match by id

`GET /handball/matches/{id}`

## Request

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

- HandballDetailedMatchResponseDto[]
  - `id` number, required
  - `week` object
  - `date` string, required
  - `country` HandballCountryResponseDto, required
    - `code` string, required: Country code specified by the ISO 3166 standard.
    - `name` string, required
    - `logo` string, required
  - `awayTeam` HandballTeamResponseDto, required
    - `id` number, required
    - `logo` string
    - `name` string, required
  - `homeTeam` HandballTeamResponseDto, required
    - `id` number, required
    - `logo` string
    - `name` string, required
  - `league` HandballMatchLeagueResponseDto, required
    - `id` number, required
    - `season` number, required
    - `name` string, required
    - `logo` string
  - `state` HandballMatchStateResponseDto, required
    - `description` 'Not started' | 'First half' | 'Half time' | 'Second half' | 'Extra time' | 'Break time' | 'Penalties' | 'Suspended' | 'Interrupted' | 'Finished' | 'Postponed' | 'Cancelled' | 'Abandoned' | 'Awarded' | 'Unknown' | 'To be announced' | 'Finished after penalties' | 'Finished after extra time', required: State of the match.
    - `score` HandballMatchScoreResponseDto, required
      - `current` string: Home - Away match score.
      - `firstHalf` string: Home - Away match score in the first half.
      - `secondHalf` string: Home - Away match score in the second half.
  - `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)