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

# Volleyball V2 API Overview

> 115 endpoints for comprehensive volleyball data: live scores, standings, player stats, and betting odds

## Overview

The **Volleyball V2 (Enhanced)** API provides 115 endpoints covering live matches, tournament standings, team rosters, player statistics, and betting odds for volleyball leagues worldwide.

### Base URL

```
https://api.sportsapipro.com/v2/volleyball
```

### 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/volleyball/live
```

***

## Volleyball-Specific Notes

### Scoring System

* **Best of 3 or 5 sets** depending on tournament rules
* Sets are played to **25 points** (must win by 2)
* Deciding set (3rd or 5th) is played to **15 points**
* Score fields: `period1` through `period5` represent set scores

### Positions

| Position       | Abbreviation |
| -------------- | ------------ |
| Setter         | S            |
| Outside Hitter | OH           |
| Middle Blocker | MB           |
| Opposite       | OPP          |
| Libero         | L            |

### Key Statistics

* **Kills** — successful attacking hits
* **Blocks** — points scored at the net
* **Aces** — direct points from serves
* **Digs** — successful defensive passes
* **Serve %** — serve success rate

### Rotation

* 6 players on court, rotate clockwise after winning serve

***

## Test IDs for Development

| Entity     | Name               | ID         |
| ---------- | ------------------ | ---------- |
| Tournament | PlusLiga (Poland)  | `831`      |
| Season     | 2025/26            | `81027`    |
| Team       | PGE Skra Bełchatów | `25955`    |
| Team       | Norwid Częstochowa | `297614`   |
| Match      | Norwid vs Skra     | `14994315` |

***

## Endpoint Groups

| Group                                                             | Endpoints | Description                   |
| ----------------------------------------------------------------- | --------- | ----------------------------- |
| [Live & Schedule](/api-reference/volleyball-v2/global)            | 14        | Live games, schedules, search |
| [Match](/api-reference/volleyball-v2/match)                       | 26        | Match details, stats, odds    |
| [Tournament](/api-reference/volleyball-v2/tournament)             | 27        | Leagues, seasons, standings   |
| [Team](/api-reference/volleyball-v2/team)                         | 15        | Rosters, form, transfers      |
| [Player](/api-reference/volleyball-v2/player)                     | 18        | Stats, career, media          |
| [Manager / Referee / Venue](/api-reference/volleyball-v2/manager) | 15        | Coaches, officials, arenas    |

***

## Example Requests

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

  ```javascript JavaScript theme={null}
  const response = await fetch(
    'https://api.sportsapipro.com/v2/volleyball/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/volleyball/live',
      headers={'x-api-key': 'YOUR_API_KEY'}
  )
  data = response.json()
  ```
</CodeGroup>

***

## UI Design Ideas

* **Score display**: Show set scores (e.g., 3-1) with individual set points (25-22, 23-25, 25-19, 25-21)
* **Match format**: Most pro leagues use best of 5 sets; 5th set to 15 points
* **Key stats to visualize**: Attack efficiency (kills vs errors), serve aces vs errors, blocks per set
* **Rotation**: Show current rotation position for live matches

## Sport Comparison — Volleyball vs Football vs Basketball vs Baseball

| Feature       | Volleyball                                | Football          | Basketball      | Baseball        |
| ------------- | ----------------------------------------- | ----------------- | --------------- | --------------- |
| Scoring       | 3 or 5 sets (25pts / 15pt tiebreak)       | 2 halves          | 4 quarters      | 9 innings       |
| Score fields  | period1-period5 (set scores)              | period1-period2   | period1-period4 | period1-period9 |
| Win condition | Best of 3 or 5 sets                       | Most goals        | Most points     | Most runs       |
| Key stats     | Kills, blocks, aces, digs, serve %        | Possession, shots | FG%, rebounds   | BA, ERA         |
| Positions     | Setter, Outside, Middle, Opposite, Libero | GK, D, M, F       | G, F, C         | P, C, IF, OF    |
| Transfers     | ✅                                         | ✅                 | ✅               | ✅               |