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

# Get match by id

`GET /rugby/matches/{id}`

## Request

- Base URL: `https://sports.highlightly.net`
- URL: `https://sports.highlightly.net/rugby/matches/{id}`
- Auth: none declared. Required headers: `x-rapidapi-host`, `x-rapidapi-key`
- TypeScript: <https://skmtc.dev/highlightly/apis/sports-api-highlightly/docs/rugby/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`, who the game's `referee` is and `lineups`.

Every player on the team, whether in the starting lineup or on the bench, is assigned a specific position type:

| Position       | Description                                      |
|--------------- |--------------------------------------------------|
| Forward        | Competes for possession in scrums and rucks.     |
| Back           | Handles attacking and passing play.              |
| Full Back      | Defends deep and returns kicks.                  |
| Prop           | Front-row player in the scrum.                   |
| Unknown (null) | Position not specified or unclear.               |
 
> 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`

- RugbyDetailedMatchResponseDto[]
  - `id` number, required
  - `week` string
  - `date` string, required
  - `country` RugbyCountryResponseDto, required
    - `code` string, required: Country code specified by the ISO 3166 standard.
    - `name` string, required
    - `logo` string, required
  - `awayTeam` RugbyTeamResponseDto, required
    - `id` number, required
    - `logo` string
    - `name` string, required
  - `homeTeam` RugbyTeamResponseDto, required
    - `id` number, required
    - `logo` string
    - `name` string, required
  - `league` RugbyMatchLeagueResponseDto, required
    - `id` number, required
    - `season` number, required
    - `name` string, required
    - `logo` string
  - `state` RugbyMatchStateResponseDto, required
    - `description` 'Not started' | 'First half' | 'Half time' | 'Second half' | 'Extra time' | 'Break time' | 'Penalties' | 'Suspended' | 'Interrupted' | 'Finished' | 'Finished after extra time' | 'Postponed' | 'Cancelled' | 'Abandoned' | 'Awarded' | 'Unknown' | 'To be announced', required: State of the match.
    - `score` string: Home - Away match score.
  - `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
  - `lineups` RugbyMatchLineupsResponseDto
    - `home` RugbyMatchLineupsDto, required
      - `initialLineup` RugbyMatchLineupPlayerDto[], required
        - `name` string, required
        - `shortName` string, required
        - `countryName` string
        - `birth` string
        - `height` string
        - `position` 'Full Back' | 'Back' | 'Forward' | 'Prop'
        - `shirtNumber` number, required
      - `substitutions` RugbyMatchLineupPlayerDto[], required
        - `name` string, required
        - `shortName` string, required
        - `countryName` string
        - `birth` string
        - `height` string
        - `position` 'Full Back' | 'Back' | 'Forward' | 'Prop'
        - `shirtNumber` number, required
    - `away` RugbyMatchLineupsDto, required
      - `initialLineup` RugbyMatchLineupPlayerDto[], required
        - `name` string, required
        - `shortName` string, required
        - `countryName` string
        - `birth` string
        - `height` string
        - `position` 'Full Back' | 'Back' | 'Forward' | 'Prop'
        - `shirtNumber` number, required
      - `substitutions` RugbyMatchLineupPlayerDto[], required
        - `name` string, required
        - `shortName` string, required
        - `countryName` string
        - `birth` string
        - `height` string
        - `position` 'Full Back' | 'Back' | 'Forward' | 'Prop'
        - `shirtNumber` number, 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)