Last five games

Retrieve the last five finished matches for one team.

Refresh interval

Immediately once a game is considered finished

Pagination

Not paginated

teamId is required and comes from teams.

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

A form guide here can show a draw, since a league match can finish level. The state separates a draw from a tie decided in extra time or by penalties, and Finished, Finished after extra time and Finished after penalties all mark a finished match.

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

Parameters

Request

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

const params = new URLSearchParams({
  teamId: '302038'
})
const response = await fetch(`https://handball.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://handball.highlightly.net/last-five-games',
    params={
        'teamId': '302038',
    },
    headers={
        'x-rapidapi-key': os.environ['HIGHLIGHTLY_API_KEY'],
    },
    timeout=10,
)

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

Response

Example response

[
  {
    "id": 126347903,
    "week": "9",
    "date": "2023-12-27T18:30:00.000Z",
    "country": {
      "code": "DE",
      "name": "Germany",
      "logo": "https://example.com/logos/country/DE.png"
    },
    "awayTeam": {
      "id": 332674,
      "logo": "https://example.com/logos/team/332674.png",
      "name": "Solingen W"
    },
    "homeTeam": {
      "id": 332674,
      "logo": "https://example.com/logos/team/332674.png",
      "name": "Solingen W"
    },
    "league": {
      "id": 36526,
      "season": 2023,
      "name": "1. Bundesliga Women",
      "logo": "https://example.com/logos/league/36526.png"
    },
    "state": {
      "description": "Finished",
      "score": {
        "current": "26 - 26",
        "firstHalf": "13 - 15",
        "secondHalf": "13 - 11"
      }
    }
  }
]

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

Errors