Overview
The Beach Volleyball V2 (Enhanced) API provides 101 endpoints covering live matches, tournament brackets, team/pair rosters, player statistics, and betting odds for beach volleyball worldwide.Base URL
Authentication
Include your API key in thex-api-key header:
Beach Volleyball-Specific Notes
Format
- 2v2 on sand (not 6v6 indoor)
- Best of 3 sets — Sets 1-2 to 21 points, Set 3 (tiebreak) to 15 points
- Win by 2 — no cap (scores can go 25-23, 30-28, etc.)
- Side switches every 7 points (sets 1-2) or 5 points (set 3)
Scoring
- Score fields:
period1,period2,period3(no period4/period5) - Display format:
"2-1 (21-18, 18-21, 15-12)"
Team Names (Pair Format)
- Teams are pairs of named players, not clubs
- Format:
"Player A / Player B"(e.g.,"Mol A / Sørum C") - The team name IS the player names — unique to beach volleyball
Key Statistics
| Stat | Description |
|---|---|
| Aces | Serves that score directly |
| Service errors | Serves into net or out |
| Kills | Successful attack hits |
| Attack % | Kill percentage (kills / total attacks) |
| Blocks | Points scored at the net |
| Digs | Defensive saves |
Test IDs for Development
| Entity | Name | ID |
|---|---|---|
| Category | International | 290 |
| Category | Austria | 1888 |
Endpoint Groups
| Group | Endpoints | Description |
|---|---|---|
| Live & Schedule | 14 | Live matches, schedules, search |
| Match | 22 | Match details, stats, odds |
| Tournament | 22 | Beach Pro Tour, knockout brackets |
| Team / Pair | 12 | Pair rosters, form, tournaments |
| Player | 18 | Stats, partner changes, media |
| Manager / Referee / Venue | 13 | Coaches, officials, beach courts |
Example Requests
Major Tours & Tournaments
| Tournament | Tier | Description |
|---|---|---|
| Beach Pro Tour Elite16 | Premium | 16 top teams, prize money $300K+ |
| Beach Pro Tour Challenge | Second | 32 teams |
| Beach Pro Tour Futures | Development | Emerging pairs |
| Olympic Games | Pinnacle | Every 4 years, 24 men’s + 24 women’s teams |
| World Championships | Major | FIVB biennial event |
| Continental Championships | Regional | CEV (Europe), NORCECA (N. America), CSV (S. America) |
Top Teams/Pairs (for testing)
| Pair | Country |
|---|---|
| Mol A / Sørum C | 🇳🇴 Norway |
| Evandro / Arthur | 🇧🇷 Brazil |
| Ana Patrícia / Duda | 🇧🇷 Brazil |
| Åhman D / Hellvig D | 🇸🇪 Sweden |
| Partain A / Benesh M | 🇺🇸 USA |
| Hörl / Horst | 🇦🇹 Austria |
Season Calendar
| Period | Activity |
|---|---|
| January–February | Asian/Australian events |
| March–May | Beach Pro Tour early season |
| June–July | European summer events + Olympic qualifying |
| July–August | Olympics (every 4 years) |
| August–October | Late season events |
| November–December | Off-season |
Sport Comparison — Beach Volleyball vs Indoor Volleyball
| Feature | Beach Volleyball | Indoor Volleyball |
|---|---|---|
| Players per side | 2 | 6 |
| Court surface | Sand | Hard court |
| Court size | 8m × 8m per side | 9m × 9m per side |
| Sets to win | Best of 3 (21-21-15) | Best of 5 (25-25-25-25-15) |
| Points per set | 21 (tiebreak: 15) | 25 (tiebreak: 15) |
| Substitutions | None (only 2 players) | Up to 6 per set + libero |
| Coaching | No coaching during play | Coaching allowed |
| Rotation | Players alternate serves | Full 6-position rotation |
| Block counts as touch | Yes (1 of 3) | No (separate) |
| Teams | Pairs (2 named players) | Clubs/national teams |
| Season | Mar – Oct (outdoor) | Year-round (indoor) |
| Olympics | Since 1996 | Since 1964 |