Get team by ID
GET
https://handball.highlightly.net/teams/{id}
Handball API
Retrieve one team by its id.
Use this to check whether a team you have stored still exists, or whether its name or logo has been updated since you fetched it.
Parameters
| Parameter | Type | Description |
|---|---|---|
idrequired
|
numberpath | Requested team id. |
Request
curl --request GET \
--url 'https://handball.highlightly.net/teams/{id}' \
--header 'x-rapidapi-key: YOUR_API_KEY'const response = await fetch('https://handball.highlightly.net/teams/{id}', {
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/teams/{id}',
headers={
'x-rapidapi-key': os.environ['HIGHLIGHTLY_API_KEY'],
},
timeout=10,
)
response.raise_for_status()
data = response.json()Response
idnumberrequired
logostring
namestringrequired
Example response
200 application/json
[
{
"id": 332674,
"logo": "https://example.com/logos/team/332674.png",
"name": "Solingen W"
}
]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. |
Using a team id
Team ids come from teams. Every match record carries the ids of both sides. These endpoints accept one.
| Endpoint | Parameter |
|---|---|
| Head to head | teamIdOne, teamIdTwo |
| Highlights | homeTeamId, awayTeamId |
| Last five games | teamId |
| Matches | homeTeamId, awayTeamId |
| Team statistics | id in the path |
