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

# Get match by id

`GET /basketball/matches/{id}`

## Request

- Base URL: `https://sports.highlightly.net`
- URL: `https://sports.highlightly.net/basketball/matches/{id}`
- Auth: none declared. Required headers: `x-rapidapi-host`, `x-rapidapi-key`
- TypeScript: <https://skmtc.dev/highlightly/apis/sports-api-highlightly/docs/basketball/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`, match weather `forecast`, both teams `statistics` and the `news`.

> 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`

- BasketballDetailedMatchResponseDto[]
  - `id` number, required
  - `week` string
  - `stage` string, required
  - `date` string, required
  - `country` BasketballCountryResponseDto, required
    - `code` string, required: Country code specified by the ISO 3166 standard.
    - `name` string, required
    - `logo` string, required
  - `awayTeam` BasketballTeamResponseDto, required
    - `id` number, required
    - `logo` string
    - `name` string, required
  - `homeTeam` BasketballTeamResponseDto, required
    - `id` number, required
    - `logo` string
    - `name` string, required
  - `league` BasketballMatchLeagueResponseDto, required
    - `id` number, required
    - `season` number, required
    - `name` string, required
    - `logo` string
  - `state` BasketballMatchStateResponseDto, required
    - `description` 'Not started' | 'First quarter' | 'Second quarter' | 'Third quarter' | 'Fourth quarter' | 'Over time' | 'Break time' | 'Half time' | 'Finished' | 'Finished after over time' | 'Postponed' | 'Cancelled' | 'Suspended' | 'Awarded' | 'Abandoned' | 'Unknown' | 'To be announced', required: State of the match.
    - `clock` number: Current minute of the current period.
    - `score` BasketballMatchScoreResponseDto, required
      - `current` string: Home - Away score for the match. Includes overtime as well.
      - `q1` string: Home - Away score in 1st quarter.
      - `q2` string: Home - Away score in 2nd quarter.
      - `q3` string: Home - Away score in 3rd quarter.
      - `q4` string: Home - Away score in 4th quarter.
      - `overTime` string: Home - Away score in overtime.
  - `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
  - `statistics` BasketballMatchStatisticsResponseDto[], required
    - `team` BasketballTeamResponseDto, required
      - `id` number, required
      - `logo` string
      - `name` string, required
    - `statistics` BasketballMatchStatisticsResponseItemDto[], required
      - `value` number, required
      - `displayName` 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)