Skip to main content

Base URL

Authentication

All requests require the x-api-key header:

About Water Polo

Water polo is a team sport played in a swimming pool with 7 players per side (6 field players + 1 goalkeeper). The API covers 11 categories across Europe, South America, and international competitions with approximately 35 matches per day.

Match Structure

Positions

Key Rules

  • Exclusion foul: Player excluded for 20 seconds → team plays 6v7 (man-down)
  • Man-up / Power play: Team with extra player after opponent exclusion
  • Penalty throw: Direct shot from 5m for serious fouls
  • Brutality: Player expelled for remainder of match (like red card)
  • Cap numbers: #1 = starting goalkeeper, #13 = reserve goalkeeper

Key Statistics

Goals, assists, saves, exclusions drawn/committed, man-up goals, penalty goals, steals, blocks, shot percentage.

Endpoint Categories

Total: 101 endpoints

Major Leagues

  • 🇮🇹 Italy — Serie A1
  • 🇭🇺 Hungary — OB1
  • 🇭🇷 Croatia — Championship
  • 🌍 Champions League
  • 🌐 FIFA — World Championships

Example Requests

UI Design Ideas

  • Score display: Like handball: “Pro Recco 12-8 Brescia” — higher scoring than football
  • Quarter scores: Always show Q1-Q4 breakdown (e.g., “3-2 / 4-1 / 2-3 / 3-2”)
  • Exclusion counter: Show team exclusion count — directly impacts gameplay
  • Man-up indicator: Show “6 vs 7” or “Man-Up” for 20-second exclusion periods
  • Similar to handball UI: Reuse handball patterns for scoring and stats display

Season Info

  • European club season: October–May
  • International calendar: World Championships, European Championships
  • Approximately 35 matches per day during active periods

Sport Comparison — Water Polo vs Football vs Basketball

Last modified on June 29, 2026