Volleyball API
DocumentationLiveCoveragePricingMCPStatusSign inGet a free key

DocumentationStart here

Volleyball API documentation

Volleyball API documentation

A REST API over HTTPS for indoor and beach volleyball: live scores, results with every set, rally-by-rally points and player figures, from world championships and tours to national leagues, since 2001. 21 endpoints, one JSON shape, one key.

Your first call

Get a free key with a Google sign-in, then ask for yesterday's results. The free key needs no card and gives 50 calls a day.

# Yesterday's results
curl "https://api.volleyballapi.com/v1/results/yesterday?per_page=2" \
  -H "Authorization: Bearer $VBA_KEY"

Every endpoint

Base URL https://api.volleyballapi.com. The /v1 may be left out.

EndpointWhat it returnsPlans
GET/v1/matches/liveEvery match being played now, with the running set scoresLive and Complete
GET/v1/results/yesterdayYesterday's finished matchesEvery plan
GET/v1/matchesMatches on a day or between two days, filtered by discipline, gender, status, competition or teamEvery plan
GET/v1/matches/{id}One match: teams, result, every set, duration, venue, spectators and refereesEvery plan
GET/v1/matches/{id}/pointsEvery rally of every set: the score after it, who won it and who servedLive, Archive and Complete
GET/v1/matches/{id}/playersPer-player figures for the match: points, serve, reception, attack and blockArchive and Complete
GET/v1/matches/{id}/lineupsStarting six by court zone for every set, the players who came on, and both head coachesArchive and Complete
GET/v1/export/matchesEvery match between two days in one call, with sets, venue, officials and coaches (up to 184 days)Complete
GET/v1/export/lineupsEvery lineup between two days in one call: starting six by zone, players who came on, coaches (up to 92 days)Complete
GET/v1/export/pointsEvery rally of every match between two days in one call (up to 14 days)Complete
GET/v1/competitionsCompetitions, newest first, filtered by discipline, gender, season or nameEvery plan
GET/v1/competitions/{id}One competition, with its dates and match countEvery plan
GET/v1/competitions/{id}/matchesA competition's matchesEvery plan
GET/v1/competitions/{id}/standingsLeague tables for a competition, one per pool, worked out from its resultsEvery plan
GET/v1/teamsTeams and beach pairs, found by nameEvery plan
GET/v1/teams/{id}One team: its name, kind, federation and playersEvery plan
GET/v1/teams/{id}/matchesA team's matches, newest firstEvery plan
GET/v1/playersPlayers, found by nameEvery plan
GET/v1/players/{id}One player, the teams they have played for and their career, competition by competitionEvery plan
GET/v1/head-to-headEvery meeting of two teams, with the record between themLive, Archive and Complete
GET/v1/usageYour plan, your calls today and this month, your limits and the dates you can readEvery plan

The basics

Use with Claude and agents

The agent skill teaches Claude, Cursor and other agents how to use the Volleyball API: getting a key, the calls that answer common questions, the limits and the errors. Pair it with the MCP server so the agent can make the calls itself.

Download SKILL.md

Save it as ~/.claude/skills/volleyballapi/SKILL.md, or upload it as a skill in Claude's settings. Agents also find it at /.well-known/agent-skills/index.json.