The volleyball data API for developers.

# Every match being played now
curl https://api.volleyballapi.com/v1/matches/live \
  -H "Authorization: Bearer $VBA_KEY"

# One day, beach only, 200 a page
curl "https://api.volleyballapi.com/v1/matches?date=2026-11-12&discipline=beach&per_page=200" \
  -H "X-API-Key: $VBA_KEY"

# Every rally of a match
curl https://api.volleyballapi.com/v1/matches/mt_3snvqtp8/points \
  -H "Authorization: Bearer $VBA_KEY"

// Yesterday's results
$ch = curl_init('https://api.volleyballapi.com/v1/results/yesterday');
curl_setopt_array($ch, [
    CURLOPT_HTTPHEADER     => ['Authorization: Bearer ' . getenv('VBA_KEY')],
    CURLOPT_RETURNTRANSFER => true,
]);
$res = json_decode(curl_exec($ch), true);

foreach ($res['data'] as $m) {
    printf("%s %d-%d %s\n", $m['team_a']['name'],
        $m['score']['a'], $m['score']['b'], $m['team_b']['name']);
}
// MOYA Radomka Radom 0-3 LOTTO Chemik Police

# Break points in every set of a match
import os, requests

r = requests.get(
    "https://api.volleyballapi.com/v1/matches/mt_3snvqtp8/points",
    headers={"Authorization": f"Bearer {os.environ['VBA_KEY']}"},
)
for s in r.json()["data"]["sets"]:
    breaks = sum(1 for p in s["rallies"] if p["won_by"] == p["served_by"])
    print(s["set"], len(s["rallies"]), "rallies", breaks, "break points")

// Page through a month with the cursor
let url = "https://api.volleyballapi.com/v1/matches?from=2026-10-01&to=2026-10-31";
const all = [];
while (url) {
  const res = await fetch(url, { headers: { "X-API-Key": process.env.VBA_KEY } });
  const { data, meta } = await res.json();
  all.push(...data);
  url = meta.next_cursor
    ? `https://api.volleyballapi.com/v1/matches?cursor=${meta.next_cursor}`
    : null;
}
console.log(all.length, "matches");