Handball API Tech Docs

Handball API Recent Match List

Provides the result list of the last 20 matches between the two teams in overall, with home and away filters.

Handball Recent Match List Request URL

GET

References / Dependencies

Tournament ID The id of the tournament. You can find list of tournament from Tournament List endpoint

Stage / Round Structure Stage / Round structures change tournament by tournament. You can find the structures with Tournament Id from Tournament Info endpoint

Teams Informations The informations of teams in the tournament. You can find list of the teams from Tournament Teams endpoint

Call Rate / Interval

Recommended API Call Interval: Daily Max API Call:

Request Headers

Data	Type	O / R	Example	Description
languageId	INT	R	{languageId}	The id of the language that you select.
Ocp-Apim-Subscription-Key	STR	R	{yourOcp-Apim-Subscription-Key}	Your account key.
Accept	STR	O	application/xml	Selection of data presentation type as XML/JSON.

^*O= Optional, R= Required

Request Parameters

Data	Type	O / R	Example	Description
matchId	INT	R	{matchId}	The id of the match.

Response Output

{ "homeTeam": { "name": "MOL-Pick Szeged", "shortName": "PS", "mediumName": "Pick Szeged", "id": 271 }, "awayTeam": { "name": "Paris Saint Germain HB", "shortName": "PSG", "mediumName": "Paris SG", "id": 346 }, "status": { "name": "Postponed", "shortName": "PSP", "id": 21 }, "h2h": { "results": { "overall": [ { "homeTeam": { "score": { "regular": 27, "halfTime": 14, "current": 27 }, "name": "MOL-Pick Szeged", "shortName": "PS", "id": 271 }, "awayTeam": { "score": { "regular": 30, "halfTime": 16, "current": 30 }, "name": "Paris Saint Germain HB", "shortName": "PSG", "id": 346 }, "status": { "name": "Full Time", "shortName": "FT", "id": 5 }, "date": "23/04/2017 15:00:00", "id": 44380, "tournament": { "name": "European Champ. League, Men ", "shortName": "ECLM", "id": 3 }, "stage": { "name": "Quarter Final", "shortName": "QF", "id": 4196 } }, { "homeTeam": { "score": { "regular": 30, "halfTime": 16, "current": 30 }, "name": "Paris Saint Germain HB", "shortName": "PSG", "id": 346 }, "awayTeam": { "score": { "regular": 30, "halfTime": 17, "current": 30 }, "name": "MOL-Pick Szeged", "shortName": "PS", "id": 271 }, "status": { "name": "Full Time", "shortName": "FT", "id": 5 }, "date": "29/04/2017 18:45:00", "id": 44381, "tournament": { "name": "European Champ. League, Men ", "shortName": "ECLM", "id": 3 }, "stage": { "name": "Quarter Final", "shortName": "QF", "id": 4196 } }, { "homeTeam": { "score": { "regular": 33, "halfTime": 15, "current": 33 }, "name": "Paris Saint Germain HB", "shortName": "PSG", "id": 346 }, "awayTeam": { "score": { "regular": 31, "halfTime": 14, "current": 31 }, "name": "MOL-Pick Szeged", "shortName": "PS", "id": 271 }, "status": { "name": "Full Time", "shortName": "FT", "id": 5 }, "date": "04/11/2018 16:00:00", "id": 49607, "tournament": { "name": "European Champ. League, Men ", "shortName": "ECLM", "id": 3 }, "stage": { "name": "Group B", "shortName": "B Gr", "id": 4968 } }, { "homeTeam": { "score": { "regular": 33, "halfTime": 16, "current": 33 }, "name": "MOL-Pick Szeged", "shortName": "PS", "id": 271 }, "awayTeam": { "score": { "regular": 32, "halfTime": 14, "current": 32 }, "name": "Paris Saint Germain HB", "shortName": "PSG", "id": 346 }, "status": { "name": "Full Time", "shortName": "FT", "id": 5 }, "date": "24/11/2018 16:30:00", "id": 49652, "tournament": { "name": "European Champ. League, Men ", "shortName": "ECLM", "id": 3 }, "stage": { "name": "Group B", "shortName": "B Gr", "id": 4968 } }, { "homeTeam": { "score": { "regular": 30, "halfTime": 16, "current": 30 }, "name": "Paris Saint Germain HB", "shortName": "PSG", "id": 346 }, "awayTeam": { "score": { "regular": 25, "halfTime": 14, "current": 25 }, "name": "MOL-Pick Szeged", "shortName": "PS", "id": 271 }, "status": { "name": "Full Time", "shortName": "FT", "id": 5 }, "date": "22/09/2019 17:00:00", "id": 56726, "tournament": { "name": "European Champ. League, Men ", "shortName": "ECLM", "id": 3 }, "stage": { "name": "Group A", "shortName": "A Gr", "id": 5531 } }, { "homeTeam": { "score": { "regular": 32, "halfTime": 15, "current": 32 }, "name": "MOL-Pick Szeged", "shortName": "PS", "id": 271 }, "awayTeam": { "score": { "regular": 29, "halfTime": 18, "current": 29 }, "name": "Paris Saint Germain HB", "shortName": "PSG", "id": 346 }, "status": { "name": "Full Time", "shortName": "FT", "id": 5 }, "date": "16/02/2020 16:00:00", "id": 56851, "tournament": { "name": "European Champ. League, Men ", "shortName": "ECLM", "id": 3 }, "stage": { "name": "Group A", "shortName": "A Gr", "id": 5531 } } ], "home": [ { "homeTeam": { "score": { "regular": 27, "halfTime": 14, "current": 27 }, "name": "MOL-Pick Szeged", "shortName": "PS", "id": 271 }, "awayTeam": { "score": { "regular": 30, "halfTime": 16, "current": 30 }, "name": "Paris Saint Germain HB", "shortName": "PSG", "id": 346 }, "status": { "name": "Full Time", "shortName": "FT", "id": 5 }, "date": "23/04/2017 15:00:00", "id": 44380, "tournament": { "name": "European Champ. League, Men ", "shortName": "ECLM", "id": 3 }, "stage": { "name": "Quarter Final", "shortName": "QF", "id": 4196 } }, { "homeTeam": { "score": { "regular": 33, "halfTime": 16, "current": 33 }, "name": "MOL-Pick Szeged", "shortName": "PS", "id": 271 }, "awayTeam": { "score": { "regular": 32, "halfTime": 14, "current": 32 }, "name": "Paris Saint Germain HB", "shortName": "PSG", "id": 346 }, "status": { "name": "Full Time", "shortName": "FT", "id": 5 }, "date": "24/11/2018 16:30:00", "id": 49652, "tournament": { "name": "European Champ. League, Men ", "shortName": "ECLM", "id": 3 }, "stage": { "name": "Group B", "shortName": "B Gr", "id": 4968 } }, { "homeTeam": { "score": { "regular": 32, "halfTime": 15, "current": 32 }, "name": "MOL-Pick Szeged", "shortName": "PS", "id": 271 }, "awayTeam": { "score": { "regular": 29, "halfTime": 18, "current": 29 }, "name": "Paris Saint Germain HB", "shortName": "PSG", "id": 346 }, "status": { "name": "Full Time", "shortName": "FT", "id": 5 }, "date": "16/02/2020 16:00:00", "id": 56851, "tournament": { "name": "European Champ. League, Men ", "shortName": "ECLM", "id": 3 }, "stage": { "name": "Group A", "shortName": "A Gr", "id": 5531 } } ], "away": [ { "homeTeam": { "score": { "regular": 30, "halfTime": 16, "current": 30 }, "name": "Paris Saint Germain HB", "shortName": "PSG", "id": 346 }, "awayTeam": { "score": { "regular": 30, "halfTime": 17, "current": 30 }, "name": "MOL-Pick Szeged", "shortName": "PS", "id": 271 }, "status": { "name": "Full Time", "shortName": "FT", "id": 5 }, "date": "29/04/2017 18:45:00", "id": 44381, "tournament": { "name": "European Champ. League, Men ", "shortName": "ECLM", "id": 3 }, "stage": { "name": "Quarter Final", "shortName": "QF", "id": 4196 } }, { "homeTeam": { "score": { "regular": 33, "halfTime": 15, "current": 33 }, "name": "Paris Saint Germain HB", "shortName": "PSG", "id": 346 }, "awayTeam": { "score": { "regular": 31, "halfTime": 14, "current": 31 }, "name": "MOL-Pick Szeged", "shortName": "PS", "id": 271 }, "status": { "name": "Full Time", "shortName": "FT", "id": 5 }, "date": "04/11/2018 16:00:00", "id": 49607, "tournament": { "name": "European Champ. League, Men ", "shortName": "ECLM", "id": 3 }, "stage": { "name": "Group B", "shortName": "B Gr", "id": 4968 } }, { "homeTeam": { "score": { "regular": 30, "halfTime": 16, "current": 30 }, "name": "Paris Saint Germain HB", "shortName": "PSG", "id": 346 }, "awayTeam": { "score": { "regular": 25, "halfTime": 14, "current": 25 }, "name": "MOL-Pick Szeged", "shortName": "PS", "id": 271 }, "status": { "name": "Full Time", "shortName": "FT", "id": 5 }, "date": "22/09/2019 17:00:00", "id": 56726, "tournament": { "name": "European Champ. League, Men ", "shortName": "ECLM", "id": 3 }, "stage": { "name": "Group A", "shortName": "A Gr", "id": 5531 } } ] } }, "date": "17/09/2020 16:45:00", "id": 59297, "tournament": { "name": "European Champ. League, Men ", "shortName": "ECLM", "id": 3 }, "stage": { "name": "Group A", "shortName": "A Gr", "id": 5768 }, "round": { "name": "Round 1", "shortName": "W1", "id": 1 } }

Response Output Definitions

match

Data

Type

Example

Description

INT

59297

The id of the match

date

DATE/STR

17/09/2020 16:45:00

The kick-off date of the match, also includes the time

tournament

Data	Type	Example	Description
name	STR	European Champ. League, Men	The full name of the tournament
shortName	STR	ECLM	The short name of the tournament
id	INT	3	The id of the tournament

homeTeam/awayTeam

Data	Type	Example	Description
name	STR	Paris Saint Germain HB	The full name of the homeTeam/awayTeam
shortName	STR	PSG	The short name of the homeTeam/awayTeam
mediumName	STR	Paris SG	The medium name of the homeTeam/awayTeam
id	INT	346	The id of the homeTeam/awayTeam

status

Data	Type	Example	Description
name	STR	Postponed	The name of the status
shortName	STR	PSP	The short name of the status
id	INT	21	The id of the status

h2h

results

overall/home/away

homeTeam/awayTeam

Data

Type

Example

Description

name

STR

MOL-Pick Szeged

The full name of the homeTeam/awayTeam

shortName

STR

The short name of the homeTeam/awayTeam

INT

271

The id of the homeTeam/awayTeam

score

Data	Type	Example	Description
current	INT	27	The current score of the match for home/away team
regular	INT	27	The set1 score of the match for home/away team
halftime	INT	14	The set2 score of the match for home/away team
penalties	INT	5	The set2 score of the match for home/away team
extraTime	INT	2	The set4 score of the match for home/away team

status

Data	Type	Example	Description
name	STR	Full Time	The name of the status
shortName	STR	FT	The short name of the status
id	INT	5	The id of the status

tournament

Data	Type	Example	Description
name	STR	European Champ. League, Men	The name of the tournament
shortName	STR	ECLM	The short name of the tournament
id	INT	3	The id of the tournament

stage

Data	Type	Example	Description
name	STR	Quarter Final	The name of the stage
shortName	WF		The short name of the stsage
id	INT	4196	The id of the stage

stage

Data	Type	Example	Description
name	STR	Group A	The name of the stage
shortName	STR	A Gr	The short name of the stage
id	INT	5768	The id of the stage

round

Data	Type	Example	Description
name	STR	Round 1	The name of the round
shortName	STR	W1	The short name of the round
id	INT	1	The id of the round

Handball API Tech Docs

Tech Docs Index

Documentation

Widgets

Lookups

Global API

Soccer API

Basketball API

Football API

Baseball API

Ice Hockey API

Volleyball API

Handball API

Table Tennis API

Tennis API

Handball API Recent Match List

Handball Recent Match List Request URL

References / Dependencies

Call Rate / Interval

Request Headers

Request Parameters

Response Output

Response Output Definitions

match

tournament

homeTeam/awayTeam

status

h2h

results

overall/home/away

homeTeam/awayTeam

score

status

tournament

stage

stage

round