DocumentationGuides
Volleyball lineups and player statistics guide
Lineups and player figures
The starting six by court zone for every set, who came on, both head coaches, and each player's points, serve, reception, attack and block.
What it covers
For the national leagues whose match sheets carry them: the starting six of each set by court zone (zone 1 serves first), liberos marked, the players who came on, both head coaches, and each player's figures for the match. A player who was on court and did none of something shows 0; a player who never came on shows null. On the Archive and Complete plans.
The endpoints
| Endpoint | What it returns |
|---|---|
| GET /v1/matches/{id}/lineups | Starting six by court zone for every set, the players who came on, and both head coaches |
| GET /v1/matches/{id}/players | Per-player figures for the match: points, serve, reception, attack and block |
| GET /v1/export/lineups | Every lineup between two days in one call: starting six by zone, players who came on, coaches (up to 92 days) |
How the records link
Players are linked by id to their own record and career, and to the team they played for in that match.
Who started, and where
Starters by zone for every set, the players who came on and both coaches.
# Who started, and where curl "https://api.volleyballapi.com/v1/matches/mt_gb8xfagd/lineups" \ -H "Authorization: Bearer $VBA_KEY"
$ch = curl_init('https://api.volleyballapi.com/v1/matches/mt_gb8xfagd/lineups'); curl_setopt_array($ch, [ CURLOPT_HTTPHEADER => ['Authorization: Bearer ' . getenv('VBA_KEY')], CURLOPT_RETURNTRANSFER => true, ]); $res = json_decode(curl_exec($ch), true); print_r($res['data']);
import os, requests r = requests.get( "https://api.volleyballapi.com/v1/matches/mt_gb8xfagd/lineups", headers={"Authorization": f"Bearer {os.environ['VBA_KEY']}"}, ) print(r.json()["data"])
const res = await fetch("https://api.volleyballapi.com/v1/matches/mt_gb8xfagd/lineups", { headers: { "X-API-Key": process.env.VBA_KEY }, }); const { data, meta } = await res.json();
Every player's figures
Points, break points, serve, reception, attack and block, both teams.
# Every player's figures curl "https://api.volleyballapi.com/v1/matches/mt_gb8xfagd/players" \ -H "Authorization: Bearer $VBA_KEY"
$ch = curl_init('https://api.volleyballapi.com/v1/matches/mt_gb8xfagd/players'); curl_setopt_array($ch, [ CURLOPT_HTTPHEADER => ['Authorization: Bearer ' . getenv('VBA_KEY')], CURLOPT_RETURNTRANSFER => true, ]); $res = json_decode(curl_exec($ch), true); print_r($res['data']);
import os, requests r = requests.get( "https://api.volleyballapi.com/v1/matches/mt_gb8xfagd/players", headers={"Authorization": f"Bearer {os.environ['VBA_KEY']}"}, ) print(r.json()["data"])
const res = await fetch("https://api.volleyballapi.com/v1/matches/mt_gb8xfagd/players", { headers: { "X-API-Key": process.env.VBA_KEY }, }); const { data, meta } = await res.json();
Stuck on something?
Ask support