Handball API Documentation

Get the list of available timezone to be used in the games endpoint.

This endpoint does not require any parameters.

All seasons are only 4-digit keys, so for a league whose season is 2018-2019 the season in the API will be 2018.

All seasons can be used in other endpoints as filters.

This endpoint does not require any parameters.

Get the list of available countries.

The name, id and code fields can be used in other endpoints as filters.

All the parameters of this endpoint can be used together.

Get the list of available leagues and cups.

The league id are unique in the API and leagues keep it across all seasons

You can find all the leagues ids on our [Dashboard](https://dashboard.sportsdataapi.com/handball/ids).

Most of the parameters of this endpoint can be used together.

Get data about teams.

The team id are unique in the API and teams keep it among all the leagues/cups in which they participate.

You can find all the teams ids on our [Dashboard](https://dashboard.sportsdataapi.com/handball/ids/teams).

This endpoint requires at least one parameter.

Get the standings for a league.

Return a table of one or more rankings according to the league / cup. Some competitions have several rankings in a year, regular season, pre season etc…

To know the list of available stages or groups you have to use the endpoint standings/stages or standings/groups

Standings are updated every hours

Get the list of available stages for a league to be used in the standings endpoint.

Get the list of available groups for a league to be used in the standings endpoint.

For all requests to games you can add the query parameter timezone to your request in order to retrieve the list of games in the time zone of your choice like *“Europe/London“*

To know the list of available time zones you have to use the endpoint timezone.

Available status

* NS : Not Started * 1H : First Half (In Play) * 2H : Second Half (In Play) * HT : Half Time (In Play) * ET : Extra Time (In Play) * BT : Break Time (In Play) * PT : Penalties Time (In Play) * AW : Awarded * POST : Postponed * CANC : Cancelled * INTR : Interrupted * ABD : Abandoned * WO : Walkover * AET : After Extra Time (Game Finished) * AP : After Penalties (Game Finished) * FT : Finished (Game Finished)

Games are updated every 15 seconds

This endpoint requires at least one parameter.

Get heads to heads between two teams.

Get odds from games or leagues.

We provide pre-match odds between 1 and 7 days before the game.

We keep a 7-day history *(The availability of odds may vary according to the leagues, seasons, games and bookmakers)*

Odds are updated once a day

Get all available bets.

All bets id can be used in endpoint odds as filters

Get all available bookmakers.

All bookmakers id can be used in endpoint odds as filters.