Volleyball API documentation

Authentication

Pass your API key in the APIkey parameter of every request. You find it on your account page.

Parameters that accept keys (match_key, league_key, country_key, team_key) take one value or several, separated by commas: league_key=4,176.

Errors & limits

When a request fails the response has error: "1" and a list of messages with a code:

Every plan has a daily number of requests. You can follow your consumption on the usage page.

Countries

Returns the countries and regions that have volleyball competitions included in your plan.

Parameters

Try it

Example response

{
  "success": 1,
  "result": [
    { "country_key": 43, "country_name": "Africa" },
    { "country_key": 3, "country_name": "Germany" }
  ]
}

PHP example

$url = 'https://api.api-volleyball.com/volleyball/?method=get_countries&APIkey=' . $apiKey;
$response = json_decode(file_get_contents($url), true);

if (!empty($response['success'])) {
    print_r($response['result']);
}

Leagues

Returns the leagues, cups and international tournaments available, with their country and current season.

Parameters

Try it

Example response

{
  "success": 1,
  "result": [
    {
      "league_key": 4,
      "league_name": "1. Bundesliga",
      "country_key": 3,
      "country_name": "Germany",
      "league_season": "2026/2027"
    }
  ]
}

PHP example

$url = 'https://api.api-volleyball.com/volleyball/?method=get_leagues&APIkey=' . $apiKey;
$response = json_decode(file_get_contents($url), true);

if (!empty($response['success'])) {
    print_r($response['result']);
}

Fixtures

Returns matches between two dates (or for a league or a single match) with final result and the score of every set. Point by point and events are included when you request one match (match_key) or set with_details=1.

Parameters

Response fields

Try it

Example response

{
  "success": 1,
  "result": [
    {
      "event_key": 38,
      "event_date": "2026-10-04",
      "event_time": "09:00",
      "event_home_team": "Lileya W",
      "home_team_key": 74,
      "event_away_team": "Minchanka 2 W",
      "away_team_key": 75,
      "event_final_result": "3 - 1",
      "event_set_score": null,
      "event_serve": null,
      "event_winner": "Home",
      "event_status": "Finished",
      "event_live": "0",
      "country_key": 45,
      "country_name": "Belarus",
      "league_key": 194,
      "league_name": "Championship Women",
      "league_round": null,
      "league_season": "2026/2027",
      "scores": [
        { "score_set": "1", "score_home": "25", "score_away": "16" },
        { "score_set": "2", "score_home": "23", "score_away": "25" },
        { "score_set": "3", "score_home": "25", "score_away": "22" },
        { "score_set": "4", "score_home": "25", "score_away": "21" }
      ]
    }
  ]
}

PHP example

$url = 'https://api.api-volleyball.com/volleyball/?method=get_fixtures&APIkey=' . $apiKey;
$response = json_decode(file_get_contents($url), true);

if (!empty($response['success'])) {
    print_r($response['result']);
}

Livescore

Returns the matches being played right now with sets, the current set score, the serving team, point by point and match events.

Parameters

Try it

Example response

Illustrative values with fictional teams.

{
  "success": 1,
  "result": [
    {
      "event_key": 1234,
      "event_date": "2026-10-08",
      "event_time": "17:00",
      "event_home_team": "VC Northport",
      "home_team_key": 501,
      "event_away_team": "Harbor Spikers",
      "away_team_key": 502,
      "event_final_result": "1 - 1",
      "event_set_score": "19 - 17",
      "event_serve": "Home",
      "event_winner": null,
      "event_status": "Set 3",
      "event_live": "1",
      "country_key": 3,
      "country_name": "Germany",
      "league_key": 4,
      "league_name": "1. Bundesliga",
      "league_round": "1. Bundesliga - Regular Season",
      "league_season": "2026/2027",
      "scores": [
        { "score_set": "1", "score_home": "25", "score_away": "21" },
        { "score_set": "2", "score_home": "22", "score_away": "25" },
        { "score_set": "3", "score_home": "19", "score_away": "17" }
      ],
      "pointbypoint": [
        {
          "set_number": 1,
          "points": [
            { "number_point": 1, "score": "1 - 0", "winner": "Home" },
            { "number_point": 2, "score": "1 - 1", "winner": "Away" }
          ]
        }
      ],
      "events": [
        { "set_number": 1, "type": "race", "team": "Away", "points": 5, "text": "Set 1 - Race to 5 points - Harbor Spikers" },
        { "set_number": 1, "type": "tie_after", "team": null, "points": 10, "text": "Set 1 Tie After 10" },
        { "set_number": 3, "type": "timeout", "team": null, "points": null, "text": "Time Out" }
      ]
    }
  ]
}

PHP example

$url = 'https://api.api-volleyball.com/volleyball/?method=get_livescore&APIkey=' . $apiKey;
$response = json_decode(file_get_contents($url), true);

if (!empty($response['success'])) {
    print_r($response['result']);
}

H2H (Head to Head)

Returns the last 10 finished meetings between two teams and the last 10 finished matches of each team.

Parameters

Try it

Example response

{
  "success": 1,
  "result": {
    "H2H": [
      {
        "event_key": 38,
        "event_date": "2026-10-04",
        "event_home_team": "Lileya W",
        "event_away_team": "Minchanka 2 W",
        "event_final_result": "3 - 1",
        "event_winner": "Home",
        "league_name": "Championship Women",
        "scores": [ { "score_set": "1", "score_home": "25", "score_away": "16" } ]
      }
    ],
    "firstTeamResults": [ ... ],
    "secondTeamResults": [ ... ]
  }
}

PHP example

$url = 'https://api.api-volleyball.com/volleyball/?method=get_H2H&APIkey=' . $apiKey;
$response = json_decode(file_get_contents($url), true);

if (!empty($response['success'])) {
    print_r($response['result']);
}

Standings

Returns the league table, grouped by stage and group (regular season, play-offs, pools).

Parameters

Response fields

Try it

Example response

{
  "success": 1,
  "result": [
    {
      "league_key": 45,
      "league_season": "2026/2027",
      "stage": "Serie A1 Women - Regular Season",
      "group": "",
      "standings": [
        {
          "place": 1,
          "team_key": 143,
          "team_name": "Conegliano W",
          "played": 1,
          "won": 1,
          "lost": 0,
          "sets_won": 3,
          "sets_lost": 0,
          "points_for": null,
          "points_against": null,
          "points": "3",
          "form": "",
          "description": "Promotion - Serie A1 Women (Play Offs: Quarter-finals)"
        }
      ]
    }
  ]
}

PHP example

$url = 'https://api.api-volleyball.com/volleyball/?method=get_standings&APIkey=' . $apiKey;
$response = json_decode(file_get_contents($url), true);

if (!empty($response['success'])) {
    print_r($response['result']);
}

Teams

Returns team details and the leagues each team plays in. Use team_key for specific teams or league_key for all the teams of a league.

Parameters

Try it

Example response

{
  "success": 1,
  "result": [
    {
      "team_key": 711,
      "team_name": "BR Volleys",
      "team_country": null,
      "team_logo": null,
      "leagues": [
        { "league_key": 4, "league_name": "1. Bundesliga", "country_name": "Germany" }
      ]
    }
  ]
}

PHP example

$url = 'https://api.api-volleyball.com/volleyball/?method=get_teams&APIkey=' . $apiKey;
$response = json_decode(file_get_contents($url), true);

if (!empty($response['success'])) {
    print_r($response['result']);
}

Odds

Returns pre-match odds grouped by match, market, selection and bookmaker. Markets with a line (handicap, totals) have one more level with the line.

Parameters

Try it

Example response

{
  "success": 1,
  "result": {
    "15": {
      "Home/Away": {
        "Home": { "Marathon": "1.21", "Betfair": "1.29", "1xBet": "1.22" },
        "Away": { "bet365": "3.40", "Marathon": "3.62", "Betfair": "3.25", "1xBet": "3.66" }
      },
      "Correct Score": {
        "3:0": { "bet365": "2.62", "Marathon": "2.57", "1xBet": "2.53" },
        "3:1": { "bet365": "3.60", "Marathon": "3.26", "1xBet": "3.26" }
      },
      "Over/Under": {
        "Over": { "3.5": { "Marathon": "1.54" }, "4.5": { "Marathon": "3.28" } },
        "Under": { "3.5": { "Marathon": "2.25" }, "4.5": { "Marathon": "1.27" } }
      }
    }
  }
}

PHP example

$url = 'https://api.api-volleyball.com/volleyball/?method=get_odds&APIkey=' . $apiKey;
$response = json_decode(file_get_contents($url), true);

if (!empty($response['success'])) {
    print_r($response['result']);
}

Live OddsBusiness & Ultra

Returns in-play odds for the matches being played, together with the live match data.

Parameters

Try it

Example response

Illustrative match with fictional teams; markets and odds format as delivered by the feed.

{
  "success": 1,
  "result": {
    "1234": {
      "event_key": 1234,
      "event_home_team": "VC Northport",
      "event_away_team": "Harbor Spikers",
      "event_final_result": "1 - 0",
      "event_set_score": "9 - 4",
      "event_status": "Set 2",
      "live_odds": [
        { "odd_name": "Home/Away", "suspended": "No", "type": "Home", "value": "1.20", "handicap": null, "upd": "2026-10-08 17:41:12" },
        { "odd_name": "Home/Away", "suspended": "No", "type": "Away", "value": "4.33", "handicap": null, "upd": "2026-10-08 17:41:12" },
        { "odd_name": "Race to Points (2nd Set)", "suspended": "No", "type": "1", "value": "1.004", "handicap": "10", "upd": "2026-10-08 17:41:12" },
        { "odd_name": "Race to Points (2nd Set)", "suspended": "No", "type": "2", "value": "17", "handicap": "-10", "upd": "2026-10-08 17:41:12" }
      ]
    }
  }
}

PHP example

$url = 'https://api.api-volleyball.com/volleyball/?method=get_live_odds&APIkey=' . $apiKey;
$response = json_decode(file_get_contents($url), true);

if (!empty($response['success'])) {
    print_r($response['result']);
}