Handball API Tech Docs

Handball API Tournament Fixture

Provides the match list of the tournaments and works only for active season

Handball Tournament Fixture 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

Call Rate / Interval

Recommended API Call Interval: 3 Request / Hour Daily Max API Call: 288 Request

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
tournamentId	INT	R	{tournamentId}	The id of the tournament.

Response Output

[ { "homeTeam": { "score": { "regular": 20, "halfTime": 10, "current": 20 }, "name": "Pas Aeropos Edessas", "shortName": "PAE", "mediumName": "Aeropos Edessas", "id": 996 }, "awayTeam": { "score": { "regular": 24, "halfTime": 13, "current": 24 }, "name": "HC Masheka", "shortName": "HCM", "mediumName": "Masheka", "id": 886 }, "status": { "name": "Full Time", "shortName": "FT", "id": 5 }, "stage": { "name": "2nd round", "shortName": "2. T", "id": 4978 }, "round": { "name": "Game 1", "shortName": "M1", "id": 199 }, "date": "05/10/2018 14:30:00", "id": 49705 }, { "homeTeam": { "score": { "regular": 20, "halfTime": 10, "current": 20 }, "name": "Colos SS4 Ciobruciu", "shortName": "CIO", "mediumName": "Ciobruciu", "id": 1458 }, "awayTeam": { "score": { "regular": 54, "halfTime": 28, "current": 54 }, "name": "Bregenz Handball", "shortName": "BGZ", "mediumName": "Bregenz", "id": 31 }, "status": { "name": "Full Time", "shortName": "FT", "id": 5 }, "stage": { "name": "2nd round", "shortName": "2. T", "id": 4978 }, "round": { "name": "Game 1", "shortName": "M1", "id": 199 }, "date": "05/10/2018 17:00:00", "id": 49721 } ]

Response Output Definitions

match

Data

Type

Example

Description

INT

49721

The id of the match.

date

DATE/STR

05/10/2018 17:00:00

The starting date of the match, includes also time.

homeTeam / awayTeam

Data

Type

Example

Description

name

STR

Bregenz Handball

Full name of the home/away team.

shortName

STR

BGZ

Short name of the home/away team.

mediumName

STR

Bregenz

Medium name of the home/away team.

INT

The id of the home/away.

score

Data	Type	Example	Description
regular	INT	54	The regular score of the match for home/away team
halfTime	INT	28	The half time score of the match for home/away team
current	INT	54	The current score of the match(live and post) 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

stage

Data	Type	Example	Description
name	STR	2nd round	The name of the stage
shortName	STR	2nd R	The short name of the stage
id	INT	4978	The id of the stage

round

Data	Type	Example	Description
name	STR	Game 1	The name of the round
shortName	STR	M1	The short name of the round
id	INT	199	The id of the round

playingRound

Data	Type	Description
name	STR	The name of the round that changed for that match
shortName	STR	The short name of the round that changed for that match
id	INT	The id of the round that changed for that match

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