> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sportsapipro.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Beach Volleyball V2 API Overview

> 101 endpoints for 2v2 beach volleyball: live scores, pair stats, tournament brackets, and betting odds

## 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

```
https://api.sportsapipro.com/v2/beach-volley
```

### Authentication

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

```bash theme={null}
curl -H "x-api-key: YOUR_API_KEY" \
  https://api.sportsapipro.com/v2/beach-volley/live
```

***

## 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](/api-reference/beach-volley-v2/global)            | 14        | Live matches, schedules, search   |
| [Match](/api-reference/beach-volley-v2/match)                       | 22        | Match details, stats, odds        |
| [Tournament](/api-reference/beach-volley-v2/tournament)             | 22        | Beach Pro Tour, knockout brackets |
| [Team / Pair](/api-reference/beach-volley-v2/team)                  | 12        | Pair rosters, form, tournaments   |
| [Player](/api-reference/beach-volley-v2/player)                     | 18        | Stats, partner changes, media     |
| [Manager / Referee / Venue](/api-reference/beach-volley-v2/manager) | 13        | Coaches, officials, beach courts  |

***

## Example Requests

<CodeGroup>
  ```bash cURL theme={null}
  curl -H "x-api-key: YOUR_API_KEY" \
    https://api.sportsapipro.com/v2/beach-volley/live
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch(
    'https://api.sportsapipro.com/v2/beach-volley/live',
    { headers: { 'x-api-key': 'YOUR_API_KEY' } }
  );
  const data = await response.json();
  ```

  ```python Python theme={null}
  import requests

  response = requests.get(
      'https://api.sportsapipro.com/v2/beach-volley/live',
      headers={'x-api-key': 'YOUR_API_KEY'}
  )
  data = response.json()
  ```
</CodeGroup>

## 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                 |