Handball V2 API Overview

115 endpoints for comprehensive handball data — live scores, standings, player stats, and betting odds

Overview

The Handball V2 (Enhanced) API provides 115 endpoints covering live matches, tournament standings, team rosters, player statistics, and betting odds for handball leagues worldwide.

Base URL

https://v2.handball.sportsapipro.com

Authentication

Include your API key in the x-api-key header:

curl -H "x-api-key: YOUR_API_KEY" \
  https://v2.handball.sportsapipro.com/api/live

---

Handball-Specific Notes

Match Format

• 2 halves × 30 minutes (60 minutes total)
• Overtime in knockout stages (2 × 5 minutes)
• Score fields: period1 and period2 represent half-time scores

Positions

Position	Abbreviation
Goalkeeper	GK
Left Wing	LW
Right Wing	RW
Left Back	LB
Center Back	CB
Right Back	RB
Pivot	PV

Key Statistics

• Goals — total goals scored
• Saves — goalkeeper save percentage
• Turnovers — ball losses
• 7m Penalties — 7-meter penalty conversion rate
• 2-min Suspensions — temporary exclusions (like hockey penalties)

Special Mechanics

• Empty goal play — team removes GK for extra outfield player
• 2-minute suspensions — temporary player exclusions
• 7-meter penalties — penalty shots from 7m line

---

Test IDs for Development

Entity	Name	ID
Tournament	EHF Champions League	30
Season	2025/26	77630
Team	Kolstad	117712
Team	Industria Kielce	8077
Match	Kolstad vs Kielce	14167791

---

Endpoint Groups

Group	Endpoints	Description
Live & Schedule	14	Live games, schedules, search
Match	26	Match details, stats, odds
Tournament	27	Leagues, seasons, standings
Team	15	Rosters, form, transfers
Player	18	Stats, career, media
Manager / Referee / Venue	15	Coaches, officials, arenas

---

Example Requests

cURL

curl -X GET "https://v2.handball.sportsapipro.com/api/live" \
  -H "x-api-key: YOUR_API_KEY"

---

UI Design Ideas

• Score display: Show half-time and full-time scores (e.g., HT 14-12, FT 28-25)
• Key stats to visualize: Goals scored/conceded, save percentage, 7m conversion rate, 2-min suspensions
• Suspensions: 2-minute temporary suspensions (like hockey penalties) — track active suspensions in live view
• Empty goal: Show indicator when team is playing with power play (extra outfield player)

Sport Comparison — Handball vs Football vs Basketball

Feature	Handball	Football (Soccer)	Basketball
Scoring	2 halves (60 min)	2 halves (90 min)	4 quarters (48 min)
Score range	20-35 per team typical	0-5 typical	80-120 typical
Score fields	period1-period2 (halves)	period1-period2	period1-period4
Key stats	Goals, saves, turnovers, 7m penalties, suspensions	Possession, shots	FG%, rebounds
Positions	GK, LW, RW, LB, CB, RB, Pivot	GK, D, M, F	G, F, C
Special rules	2-min suspensions, 7-meter penalties, empty goal	Yellow/Red cards	Fouls/technicals