Volleyball API / last-five-games

Last five games

GET https://volleyball.highlightly.net/last-five-games Volleyball API
GET https://sports.highlightly.net/volleyball/last-five-games All Sports API

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 set by set score. A form guide showing the result and how many sets it went to needs no follow up request.

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

A form guide built from recent results

Parameters

Parameter Type Description
teamIdrequired number No description in the spec.e.g. 630524

Request

curl --request GET \
  --url 'https://volleyball.highlightly.net/last-five-games?teamId=630524' \
  --header 'x-rapidapi-key: YOUR_API_KEY'
const params = new URLSearchParams({
  teamId: '630524'
})
const response = await fetch(`https://volleyball.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://volleyball.highlightly.net/last-five-games',
    params={
        'teamId': '630524',
    },
    headers={
        'x-rapidapi-key': os.environ['HIGHLIGHTLY_API_KEY'],
    },
    timeout=10,
)

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

Response

idnumberrequired
weekstring
datestringrequired
countryVolleyballCountryResponserequired3 fields
codestringrequiredCountry code specified by the ISO 3166 standard.
namestringrequired
logostringrequired
awayTeamVolleyballTeamResponserequired3 fields
idnumberrequired
logostring
namestringrequired
homeTeamVolleyballTeamResponserequired3 fields
idnumberrequired
logostring
namestringrequired
leagueVolleyballMatchLeagueResponserequired4 fields
idnumberrequired
seasonnumberrequired
namestringrequired
logostring
stateVolleyballMatchStateResponserequired8 fields
descriptionstringrequiredState of the match.Not startedFirst setSecond setThird setFourth setFifth setAwardedPostponedCancelledInterruptedAbandonedFinishedUnknownTo be announced
scoreVolleyballMatchScoreResponserequired6 fields
currentstringHome - Away score for the match.
firstSetstringHome - Away score for the first set.
secondSetstringHome - Away score for the second set.
thirdSetstringHome - Away score for the third set.
fourthSetstringHome - Away score for the fourth set.
fifthSetstringHome - Away score for the fifth set.

Example response

200 application/json 
[
  {
    "id": 126347903,
    "week": "12",
    "date": "2023-12-30T17:00:00.000Z",
    "country": {
      "code": "IT",
      "name": "Italy",
      "logo": "https://example.com/logos/country/IT.png"
    },
    "awayTeam": {
      "id": 630524,
      "logo": "https://example.com/logos/team/630524.png",
      "name": "Trentino"
    },
    "homeTeam": {
      "id": 630524,
      "logo": "https://example.com/logos/team/630524.png",
      "name": "Trentino"
    },
    "league": {
      "id": 83331,
      "season": 2023,
      "name": "SuperLega",
      "logo": "https://example.com/logos/league/83331.png"
    },
    "state": {
      "description": "Second set",
      "score": {
        "current": "3 - 1",
        "firstSet": "19 - 25",
        "secondSet": "25 - 12",
        "thirdSet": "22 - 17",
        "fourthSet": "22 - 17",
        "fifthSet": "25 - 19"
      }
    }
  }
]

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

Errors

Status Description
400 Bad request descriptive error.
500 Internal server error.