Match Endpoints

26 endpoints for handball match data: scores, lineups, statistics, odds, and more

Scoring Format

Handball uses two 30-minute halves. The /scores endpoint returns:

{
  "homeScore": { "period1": 14, "period2": 14, "current": 28 },
  "awayScore": { "period1": 12, "period2": 13, "current": 25 }
}

• period1 = 1st half goals, period2 = 2nd half goals
• overtime appears in knockout matches (2×5 min extra time)
• Typical scores: 25–35 goals per team

---

Match Details

GET /api/match/:matchId

Full match details including teams, scores, status, and venue.

Scores

GET /api/match/:matchId/scores

Half-by-half scores.

Lineups

GET /api/match/:matchId/lineups

Starting lineup.

Statistics

GET /api/match/:matchId/statistics

Match stats: goals, saves, turnovers, penalties, suspensions.

Incidents

GET /api/match/:matchId/incidents

Goals, penalties, suspensions, timeouts.

Player Statistics

GET /api/match/:matchId/player-statistics

All player stats for the match.

Individual Player Stats

GET /api/match/:matchId/player/:playerId/statistics

Best Players

GET /api/match/:matchId/best-players

Top performers of the match.

Award / MVP

GET /api/match/:matchId/award

Head to Head

GET /api/match/:matchId/h2h

Scoring Graph

GET /api/match/:matchId/graph

Scoring progression through the match.

Pre-Game Form

GET /api/match/:matchId/pregame-form

Streaks

GET /api/match/:matchId/streaks

Highlights

GET /api/match/:matchId/highlights

Media

GET /api/match/:matchId/media

Managers / Coaches

GET /api/match/:matchId/managers

Fan Votes

GET /api/match/:matchId/votes

Venue

GET /api/match/:matchId/venue

Referee

GET /api/match/:matchId/referee

TV Channels

GET /api/match/:matchId/channels

Missing Players

GET /api/match/:matchId/missing-players

Featured Odds

GET /api/match/:matchId/odds

All Odds

GET /api/match/:matchId/odds/all

Pre-Match Odds

GET /api/match/:matchId/odds/pre-match

Live Odds

GET /api/match/:matchId/odds/live

Winning Odds

GET /api/match/:matchId/winning-odds

Win probability.