Last five games

Retrieve the last five finished games for one team.

Refresh interval

Immediately once a game is considered finished

Pagination

Not paginated

teamId is required and comes from teams.

Each game comes back in the same shape as a match on matches, including the full state with the period by period score. A form guide showing the result and the final score needs no follow up request.

Read the state alongside the score when you reduce a game to a win or a loss.

This endpoint is built for the form section shown before a fixture, alongside head to head.

Parameters

Request

curl --request GET \
  --url 'https://hockey.highlightly.net/last-five-games?teamId=214385' \
  --header 'x-rapidapi-key: YOUR_API_KEY'

const params = new URLSearchParams({
  teamId: '214385'
})
const response = await fetch(`https://hockey.highlightly.net/last-five-games?${params}`, {
  headers: {
    'x-rapidapi-key': process.env.HIGHLIGHTLY_API_KEY
  }
})

if (!response.ok) {
  throw new Error(`Highlightly responded ${response.status}`)
}

const data = await response.json()

import os
import requests

response = requests.get(
    'https://hockey.highlightly.net/last-five-games',
    params={
        'teamId': '214385',
    },
    headers={
        'x-rapidapi-key': os.environ['HIGHLIGHTLY_API_KEY'],
    },
    timeout=10,
)

response.raise_for_status()
data = response.json()

Response

Example response

[
  {
    "id": 291869956,
    "week": "1",
    "date": "2023-10-13T17:30:00.000Z",
    "country": {
      "code": "DE",
      "name": "Germany",
      "logo": "https://example.com/logos/country/DE.png"
    },
    "awayTeam": {
      "id": 223746,
      "logo": "https://example.com/logos/team/223746.png",
      "name": "Frankfurt Lowen"
    },
    "homeTeam": {
      "id": 223746,
      "logo": "https://example.com/logos/team/223746.png",
      "name": "Frankfurt Lowen"
    },
    "league": {
      "id": 16953,
      "season": 2023,
      "name": "DEL",
      "logo": "https://example.com/logos/league/16953.png"
    },
    "state": {
      "description": "1st period",
      "score": {
        "current": "4 - 4",
        "overTime": "6 - 4",
        "penalties": "17 - 33",
        "firstPeriod": "2 - 0",
        "secondPeriod": "2 - 1",
        "thirdPeriod": "5 - 2"
      }
    }
  }
]

Values are the examples declared in the OpenAPI spec, not a captured live response.

Errors