Handball V2 API Overview

​

Overview

​

Base URL

https://api.sportsapipro.com/v2/handball

​

Authentication

curl -H "x-api-key: YOUR_API_KEY" \
  https://api.sportsapipro.com/v2/handball/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

​

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

​

Endpoint Groups

​

Example Requests

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

const response = await fetch(
  'https://api.sportsapipro.com/v2/handball/live',
  { headers: { 'x-api-key': 'YOUR_API_KEY' } }
);
const data = await response.json();

import requests

response = requests.get(
    'https://api.sportsapipro.com/v2/handball/live',
    headers={'x-api-key': 'YOUR_API_KEY'}
)
data = response.json()

​

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