Simple REST API. Pass your API key as a query parameter β no headers required.
https://live-volleyball-api.com/api/v1
Add api_key to every request URL. You can get a key by creating a free account.
https://live-volleyball-api.com/api/v1/matches?api_key=YOUR_KEY&date=2026-07-03
Each API call consumes credits from your balance. Credits never expire. New accounts get 100 free credits.
| Endpoint | Cost |
|---|---|
| GET /matches | 1 credit per call |
| GET /live_match_details | 1 credit per call |
| GET /csb | Free |
| GET /lineups | 1 credit per call |
| GET /h2h | 1 credit per call |
| GET /league | 1 credit per call |
| GET /league_standings | 1 credit per call |
| GET /league_fixtures | 1 credit per call |
| GET /team_matches | 1 credit per call |
| GET /team_squad | 1 credit per call |
| GET /team_standings | 1 credit per call |
| GET /player | 1 credit per call |
| GET /team_search | 1 credit per call |
| GET /player_search | 1 credit per call |
All errors return JSON with a code and message:
| Code | Meaning |
|---|---|
| 400 | Bad request β missing or invalid parameter |
| 401 | API key missing or invalid |
| 403 | Access denied β insufficient credits, daily limit exceeded, or inactive account |
| 429 | Insufficient credits |
| 500 | Database error |
| 503 | Upstream data source unavailable β retry after a few seconds |
{
"success": false,
"message": "Access denied. Possible reasons: Invalid key, insufficient credits, daily limit exceeded, or inactive account.",
"timestamp": "2026-07-03 14:22:01"
}
Returns volleyball matches for a given date. Optionally translate team and competition names.
| Parameter | Type | Required | Description |
|---|---|---|---|
| api_key | string | Yes | Your API key |
| date | string | No | Match date in YYYY-MM-DD format |
| lang | string | No | Response language: en tr de ru |
GET https://live-volleyball-api.com/api/v1/matches?api_key=YOUR_KEY&date=2026-09-01&lang=en
{
"success": true,
"credits_remaining": 4999,
"data": {
"date": "2026-09-01",
"language": "en",
"timezone": "UTC+3",
"matches": [
{
"id": "ae31818d-1eed-4f9f-abf7-84646dfe3aac",
"league": {
"id": "b823d3cc-6286-1e9b-8ed5-e492f1761c40",
"name": "European Championship Women Round of 16",
"area": "World",
"logo": "https://live-volleyball-api.com/leagues/b823d3cc-6286-1e9b-8ed5-e492f1761c40.png"
},
"date_time": "2026-09-01 16:20:00",
"kickoff": "16:20",
"status": {
"status": "live",
"display": "Live",
"is_live": true
},
"home": {
"id": "5740b6e3-8751-0dfd-1751-28c7cb764849",
"name": "Turkey (W)",
"logo": "https://live-volleyball-api.com/teams/5740b6e3-8751-0dfd-1751-28c7cb764849.png",
"sets": 1
},
"away": {
"id": "f206c54c-6d97-251a-cfdf-b74423417fa0",
"name": "Azerbaijan (W)",
"logo": "https://live-volleyball-api.com/teams/f206c54c-6d97-251a-cfdf-b74423417fa0.png",
"sets": 0
},
"current_set_points": { "home": 11, "away": 10 },
"tv_broadcast": true,
"has_live_bet": true
}
]
},
"timestamp": "2026-09-01 16:22:01"
}
scheduled, live, finished, cancelled, postponed. current_set_points β live point score of the set in progress, null unless the match is live. tv_broadcast / has_live_bet β booleans from the upstream feed. Returns match metadata: competition/round info, venue, broadcast info, the tournament bracket, and the embeddable live-commentary widget URL.
| Parameter | Type | Required | Description |
|---|---|---|---|
| api_key | string | Yes | Your API key |
| match_id | string | Yes | Match ID from /matches |
| lang | string | No | Response language: en tr de ru |
GET https://live-volleyball-api.com/api/v1/live_match_details?api_key=YOUR_KEY&match_id=ae31818d-1eed-4f9f-abf7-84646dfe3aac&lang=en
{
"success": true,
"credits_remaining": 4998,
"data": {
"match_id": "ae31818d-1eed-4f9f-abf7-84646dfe3aac",
"title": "World - European Championship Women",
"competition_name": "European Championship Women",
"area_id": "b5f65d72-ec19-43d8-5ddb-a6ff45957d02",
"league_id": "b823d3cc-6286-1e9b-8ed5-e492f1761c40",
"season_id": "1481a945-09d3-d8e9-d24d-caa45102514e",
"date_time": "2026-09-01 16:20:00",
"uncertain_time": false,
"venue": "Sinan Erdem Sports Hall",
"broadcasts": "TRT 1, tabii, TRT Spor YΔ±ldΔ±z YouTube",
"has_live_bet": true,
"home": {
"id": "5740b6e3-8751-0dfd-1751-28c7cb764849",
"name": "Turkey (W)",
"logo": "https://live-volleyball-api.com/teams/5740b6e3-8751-0dfd-1751-28c7cb764849.png"
},
"away": {
"id": "f206c54c-6d97-251a-cfdf-b74423417fa0",
"name": "Azerbaijan (W)",
"logo": "https://live-volleyball-api.com/teams/f206c54c-6d97-251a-cfdf-b74423417fa0.png"
},
"csb_url": "https://live-volleyball-api.com/csb?id=6743466&lang=en",
"bracket": { "round_names": ["Round of 16", "Quarterfinal", "Semifinal", "Final"], "rounds": [ [] ] },
"slug": "turkey-vs-azerbaijan"
},
"timestamp": "2026-09-01 16:22:01"
}
null for round-robin leagues. This endpoint does not include a live event timeline or in-match stats β use /matches for the live set score. <iframe src="csb_url" width="636" height="400" frameborder="0"></iframe>null if the match has no active live widget (e.g. pre-match or unsupported competition). Returns a live match Centre Stage Board (CSB) visualization as an HTML page β designed to be embedded in an <iframe>. The csb_url field in the /live_match_details response already contains a ready-to-use URL with a pre-fetched token; you do not need to call this endpoint manually in most cases.
| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | Yes | Numeric widget ID, extracted from the csb_url query string returned by /live_match_details β pass the whole csb_url straight into your iframe instead of building this URL by hand. |
| lang | string | No | Response language: en tr de ru |
<iframe
src="https://live-volleyball-api.com/csb?id=6743466&lang=en"
width="636"
height="400"
frameborder="0"
allowtransparency="true"
></iframe>
id from a fresh /live_match_details call rather than hardcoding it β the widget ID can change if the match is rescheduled or replayed. Returns the full team rosters (shirt number and name) submitted for the match.
| Parameter | Type | Required | Description |
|---|---|---|---|
| api_key | string | Yes | Your API key |
| match_id | string | Yes | Match ID from /matches |
| lang | string | No | Response language: en tr de ru |
GET https://live-volleyball-api.com/api/v1/lineups?api_key=YOUR_KEY&match_id=6f863cce-4607-46b5-bb14-1701d5247316&lang=en
{
"success": true,
"credits_remaining": 4997,
"data": {
"match_id": "6f863cce-4607-46b5-bb14-1701d5247316",
"home": [
{ "id": "010a289d-be42-f932-7f15-54d39782ebfb", "number": "7", "name": "A. Koulberg", "nationality_id": "a1f4a627-5510-54f7-0f17-98ee028b06bc", "image": "https://live-volleyball-api.com/people/010a289d-be42-f932-7f15-54d39782ebfb.png" },
{ "id": "0314d212-2fa0-d823-c3c2-f76bc54b5c43", "number": "10", "name": "P. Martin", "nationality_id": "a1f4a627-5510-54f7-0f17-98ee028b06bc", "image": "https://live-volleyball-api.com/people/0314d212-2fa0-d823-c3c2-f76bc54b5c43.png" }
],
"away": [
{ "id": "example-away-player-id", "number": "5", "name": "K. Lohmann", "nationality_id": "example-nationality-id", "image": "https://live-volleyball-api.com/people/example-away-player-id.png" }
]
},
"timestamp": "2026-09-01 14:22:01"
}
Returns each team's recent form (last 5 matches) and their head-to-head history against each other.
| Parameter | Type | Required | Description |
|---|---|---|---|
| api_key | string | Yes | Your API key |
| match_id | string | Yes | Match ID from /matches |
| lang | string | No | Response language: en tr de ru |
GET https://live-volleyball-api.com/api/v1/h2h?api_key=YOUR_KEY&match_id=6f863cce-4607-46b5-bb14-1701d5247316&lang=en
{
"success": true,
"credits_remaining": 4996,
"data": {
"match_id": "6f863cce-4607-46b5-bb14-1701d5247316",
"home_form": [
{ "id": "8f4a8162-9d46-8190-e45c-40e3fbfeba0d", "date": "2026-08-27", "home": "Netherlands (W)", "away": "Belgium (W)", "score": "2-3", "won": true }
],
"away_form": [
{ "id": "9e2c1a77-1234-5678-9abc-def012345678", "date": "2026-08-28", "home": "Germany (W)", "away": "Poland (W)", "score": "1-3", "won": false }
],
"h2h": [
{ "id": "example-h2h-match-id", "date": "2025-07-10", "home": "Belgium (W)", "away": "Germany (W)", "score": "3-1", "won": true }
],
"home_series": [0, 1, 1, 1, 1],
"away_series": [1, 0, 0, 1, 1]
},
"timestamp": "2026-09-01 14:22:01"
}
Returns detailed information about a single league including season, teams and logo.
| Parameter | Type | Required | Description |
|---|---|---|---|
| api_key | string | Yes | Your API key |
| league_id | string | Yes | League ID from /leagues |
| lang | string | No | Response language: en tr de ru |
GET https://live-volleyball-api.com/api/v1/league?api_key=YOUR_KEY&league_id=b823d3cc-6286-1e9b-8ed5-e492f1761c40&lang=en
{
"success": true,
"credits_remaining": 4993,
"data": {
"id": "b823d3cc-6286-1e9b-8ed5-e492f1761c40",
"name": "European Championship Women",
"logo": "https://live-volleyball-api.com/leagues/b823d3cc-6286-1e9b-8ed5-e492f1761c40.png",
"area": { "id": "b5f65d72-ec19-43d8-5ddb-a6ff45957d02", "name": "World" },
"seasons": [
{ "id": "1481a945-09d3-d8e9-d24d-caa45102514e", "name": "2026", "selected": true },
{ "id": "bedd9910-09f0-8286-cc5f-90baf99d6006", "name": "2023", "selected": false }
]
},
"timestamp": "2026-09-01 14:22:01"
}
season_id to /league_standings or /league_fixtures to view a past season instead of the current one. Returns the current standings table for a league. Supports multiple groups (e.g. Champions League group stage).
| Parameter | Type | Required | Description |
|---|---|---|---|
| api_key | string | Yes | Your API key |
| league_id | string | Yes | League ID from /leagues |
| season_id | string | No | Upstream season UUID, from the seasons array returned by /league. Omit for the current season. |
| lang | string | No | Response language: en tr de ru |
GET https://live-volleyball-api.com/api/v1/league_standings?api_key=YOUR_KEY&league_id=b823d3cc-6286-1e9b-8ed5-e492f1761c40&lang=en
{
"success": true,
"credits_remaining": 4992,
"data": {
"league_id": "b823d3cc-6286-1e9b-8ed5-e492f1761c40",
"columns": ["Rank", "Team", "P", "W", "L", "S", "Pts"],
"tabs": ["Overall", "Home", "Away"],
"zones": [ { "id": "836572bd-a2fe-1404-1743-964ec9c7baca", "name": "Qualified", "color": "#02206B" } ],
"standings": [
{
"title": "Group A",
"round_id": "99d8f31f-42b5-dd52-62e5-d7e4a7ee8fdb",
"group_id": "99d8f31f-42b5-dd52-62e5-d7e4a7ee8fdb",
"week": 5,
"max_week": 5,
"total": [
{
"team_id": "83f6313f-0cb3-ca49-c3c9-d8daaf1ce99d",
"team_name": "Poland (W)",
"logo": "https://live-volleyball-api.com/teams/83f6313f-0cb3-ca49-c3c9-d8daaf1ce99d.png",
"columns": ["1", "Poland (W)", "5", "5", "0", "15-3", "14"],
"zone_id": "836572bd-a2fe-1404-1743-964ec9c7baca"
}
],
"home": [ ],
"away": [ ]
}
]
},
"timestamp": "2026-09-01 14:22:01"
}
Returns the full match schedule for a league, grouped week by week, with scores for played matches and kickoff times for upcoming ones.
| Parameter | Type | Required | Description |
|---|---|---|---|
| api_key | string | Yes | Your API key |
| league_id | string | Yes | League ID from /leagues |
| season_id | string | No | Upstream season UUID, from the seasons array returned by /league. Omit for the current season. |
| lang | string | No | Response language: en tr de ru |
GET https://live-volleyball-api.com/api/v1/league_fixtures?api_key=YOUR_KEY&league_id=b823d3cc-6286-1e9b-8ed5-e492f1761c40&lang=tr
{
"success": true,
"credits_remaining": 4991,
"data": {
"league_id": "b823d3cc-6286-1e9b-8ed5-e492f1761c40",
"weeks": [
{
"title": "1. Week",
"matches": [
{
"id": "9a674f49-43f5-2447-56f1-71681ac5801e",
"date_time": "2026-08-21 11:00:00",
"status": "finished",
"home": {
"id": "d682a14f-59a3-a7fe-c7ab-0c3efe87fe24",
"name": "France (W)",
"logo": "https://live-volleyball-api.com/teams/d682a14f-59a3-a7fe-c7ab-0c3efe87fe24.png",
"sets": 3
},
"away": {
"id": "747b36c4-61e7-e3ab-6ab0-a8dedfa5d852",
"name": "Slovakia (W)",
"logo": "https://live-volleyball-api.com/teams/747b36c4-61e7-e3ab-6ab0-a8dedfa5d852.png",
"sets": 0
}
}
]
}
]
},
"timestamp": "2026-08-31 12:00:00"
}
Returns a team's fixtures and results for a season β both past results and upcoming matches.
| Parameter | Type | Required | Description |
|---|---|---|---|
| api_key | string | Yes | Your API key |
| team_id | string | Yes | Team ID from match data |
| season | string | No | Season year, e.g. 2026. Omit for the current season. |
| lang | string | No | Response language: en tr de ru |
GET https://live-volleyball-api.com/api/v1/team_matches?api_key=YOUR_KEY&team_id=547c6214-9072-0db0-cf71-35eacb40f104&season=2026&lang=en
{
"success": true,
"credits_remaining": 4991,
"data": {
"team_id": "547c6214-9072-0db0-cf71-35eacb40f104",
"season": "2026",
"competitions": [
{
"id": "d1e7325d-5b84-4735-bf93-8d08da440deb",
"title": "World - International Friendly Women",
"area_id": "b5f65d72-ec19-43d8-5ddb-a6ff45957d02",
"rounds": [
{
"id": "59c4337f-9b1c-4bab-b7dd-a300d32d9965",
"name": "Regular Season",
"matches": [
{
"id": "9d3939df-0c5b-4ea6-ac29-75c8a1717cba",
"date_time": "2026-05-14 19:00:00",
"status": "finished",
"home": { "id": "547c6214-9072-0db0-cf71-35eacb40f104", "name": "Italy (W)", "logo": "https://live-volleyball-api.com/teams/547c6214-9072-0db0-cf71-35eacb40f104.png", "sets": 3 },
"away": { "id": "d682a14f-59a3-a7fe-c7ab-0c3efe87fe24", "name": "France (W)", "logo": "https://live-volleyball-api.com/teams/d682a14f-59a3-a7fe-c7ab-0c3efe87fe24.png", "sets": 0 },
"won": true
}
]
}
]
}
]
},
"timestamp": "2026-09-01 14:22:01"
}
Returns the full squad list for a team with player positions and shirt numbers.
| Parameter | Type | Required | Description |
|---|---|---|---|
| api_key | string | Yes | Your API key |
| team_id | string | Yes | Team ID from match data |
| season | string | No | Season year, e.g. 2026. Omit for the current season. |
| lang | string | No | Response language: en tr de ru |
GET https://live-volleyball-api.com/api/v1/team_squad?api_key=YOUR_KEY&team_id=547c6214-9072-0db0-cf71-35eacb40f104
{
"success": true,
"credits_remaining": 4990,
"data": {
"team_id": "547c6214-9072-0db0-cf71-35eacb40f104",
"name": "Italy (W)",
"logo": "https://live-volleyball-api.com/teams/547c6214-9072-0db0-cf71-35eacb40f104.png",
"season": "2026",
"available_seasons": ["2026", "2026 Italy", "2025", "2024 Paris", "2024", "2023", "2022"],
"column_names": ["No", "Player", "P", "Age", "M", "Points", "Blk"],
"coach": {
"id": "c3d1b6c7-9278-4a14-8fc4-09b3a5a34161",
"name": "Julio Velasco",
"nationality_id": "501dc4bd-8129-8c1b-9873-704cb5165dee",
"image": "https://live-volleyball-api.com/people/c3d1b6c7-9278-4a14-8fc4-09b3a5a34161.png"
},
"players": [
{
"id": "168ec450-c327-a648-8325-f2f3b4088d18",
"name": "M. Sylla",
"number": "17",
"nationality_id": "8e69dfd6-38ee-7738-3d1c-2028011930f8",
"nationality": "Italy",
"active_team_id": "f75aa922-8e34-70e7-2c75-9635c1ce3a87",
"active_team_name": "Galatasaray Daikin (W)",
"image": "https://live-volleyball-api.com/people/168ec450-c327-a648-8325-f2f3b4088d18.png",
"columns": ["17", "M. Sylla", "S", "32", "12", "8.7", "0.8"]
}
]
},
"timestamp": "2026-09-01 14:22:01"
}
Returns a team's current position in its league(s) for the season.
| Parameter | Type | Required | Description |
|---|---|---|---|
| api_key | string | Yes | Your API key |
| team_id | string | Yes | Team ID from match data |
| lang | string | No | Response language: en tr de ru |
GET https://live-volleyball-api.com/api/v1/team_standings?api_key=YOUR_KEY&team_id=547c6214-9072-0db0-cf71-35eacb40f104&season=2026&lang=en
{
"success": true,
"credits_remaining": 4989,
"data": {
"team_id": "547c6214-9072-0db0-cf71-35eacb40f104",
"season": "2026",
"columns": ["Rank", "Team", "P", "W", "L", "S", "Pts"],
"tabs": ["Overall", "Home", "Away"],
"standings": [
{
"title": "Nations League Women",
"round_id": "bcb2531a-c8d3-402e-a8e1-a3647b8a4f6c",
"week": 12,
"max_week": 12,
"total": [
{
"team_id": "547c6214-9072-0db0-cf71-35eacb40f104",
"team_name": "Italy (W)",
"logo": "https://live-volleyball-api.com/teams/547c6214-9072-0db0-cf71-35eacb40f104.png",
"columns": ["2", "Italy (W)", "12", "10", "2", "32-14", "28"],
"zone_id": "6a4acb0f-3450-cec7-199a-d2a0e34c96ea"
}
]
}
]
},
"timestamp": "2026-09-01 14:22:01"
}
Searches for teams by name. Returns matching teams with their IDs and logos.
| Parameter | Type | Required | Description |
|---|---|---|---|
| api_key | string | Yes | Your API key |
| q | string | Yes | Search keywords (team or player name) |
| lang | string | No | Response language: en tr de ru |
GET https://live-volleyball-api.com/api/v1/team_search?api_key=YOUR_KEY&q=eczacibasi
{
"success": true,
"credits_remaining": 4990,
"data": {
"keywords": "eczacibasi",
"total": 3,
"teams": [
{
"id": "f244f38b-d084-9902-b52e-e068873c4a46",
"name": "EczacΔ±baΕΔ± Peron Δ°stanbul (W)",
"logo": "https://live-volleyball-api.com/teams/f244f38b-d084-9902-b52e-e068873c4a46.png",
"country": "Turkey"
},
{
"id": "a00b9015-94e6-c24f-9c9a-3e4ecdfffdcf",
"name": "EczacΔ±baΕΔ± II (W)",
"logo": "https://live-volleyball-api.com/teams/a00b9015-94e6-c24f-9c9a-3e4ecdfffdcf.png",
"country": "Turkey"
}
]
},
"timestamp": "2026-09-01 14:22:01"
}
Returns a player's profile (bio, position, height/weight, current club) plus their season-by-season and club/national-team career stats.
| Parameter | Type | Required | Description |
|---|---|---|---|
| api_key | string | Yes | Your API key |
| player_id | string | Yes | Player ID, as returned by /player_search |
| lang | string | No | Response language: en tr de ru |
GET https://live-volleyball-api.com/api/v1/player?api_key=YOUR_KEY&player_id=0d66ae65-5596-8a3f-9165-a1d3d5e47d14&lang=en
{
"success": true,
"credits_remaining": 4988,
"data": {
"player_id": "0d66ae65-5596-8a3f-9165-a1d3d5e47d14",
"name": "Sinead Jack-KΔ±sal",
"shirt_number": "88",
"photo": "https://live-volleyball-api.com/people/0d66ae65-5596-8a3f-9165-a1d3d5e47d14.png",
"team_id": "c86225f5-6f73-0097-474f-45c9a2357948",
"team_logo": "https://live-volleyball-api.com/teams/c86225f5-6f73-0097-474f-45c9a2357948.png",
"profile": [
{ "label": "First Name", "value": "Sinead" },
{ "label": "Last Name", "value": "Jack-KΔ±sal" },
{ "label": "Date of Birth", "value": "08 Nov 1993 (Age: 33)" },
{ "label": "Nationality", "value": "Turkey" },
{ "label": "Height", "value": "196 cm" },
{ "label": "Weight", "value": "83 kg" },
{ "label": "Position", "value": "Middle Blocker" },
{ "label": "Hand", "value": "Right" },
{ "label": "Club", "value": "FenerbahΓ§e (W)" }
],
"career": {
"column_names": ["Season", "Team", "Matches", "Points", "Blk"],
"seasons": [
{ "team_id": "f244f38b-d084-9902-b52e-e068873c4a46", "team_logo": "https://live-volleyball-api.com/teams/f244f38b-d084-9902-b52e-e068873c4a46.png", "columns": ["2025/2026", "EczacΔ±baΕΔ± Peron Δ°stanbul (W)", "43", "9.5", "2.7"] }
]
},
"clubs": {
"column_names": ["Years", "Team", "Matches", "Points", "Blk"],
"rows": [
{ "team_id": "f244f38b-d084-9902-b52e-e068873c4a46", "team_logo": "https://live-volleyball-api.com/teams/f244f38b-d084-9902-b52e-e068873c4a46.png", "columns": ["2022 - Present", "EczacΔ±baΕΔ± Dynavit (W)", "153", "6.2", "1.6"] }
]
},
"national_teams": {
"column_names": ["Years", "Team", "Matches", "Points", "Blk"],
"rows": [
{ "team_id": "5740b6e3-8751-0dfd-1751-28c7cb764849", "team_logo": "https://live-volleyball-api.com/teams/5740b6e3-8751-0dfd-1751-28c7cb764849.png", "columns": ["2025 - Present", "Turkey (W)", "22", "7.4", "1.5"] }
]
},
"slug": "sinead-jack-kisal"
},
"timestamp": "2026-09-01 14:22:01"
}
Searches for players by name. Returns matching players with their IDs and photos.
| Parameter | Type | Required | Description |
|---|---|---|---|
| api_key | string | Yes | Your API key |
| q | string | Yes | Search keywords (team or player name) |
| lang | string | No | Response language: en tr de ru |
GET https://live-volleyball-api.com/api/v1/player_search?api_key=YOUR_KEY&q=antropova
{
"success": true,
"credits_remaining": 4989,
"data": {
"keywords": "antropova",
"total": 1,
"players": [
{
"id": "23bf9fb8-bcc8-5ee0-14c4-f227d4081895",
"name": "E. Antropova",
"photo": "https://live-volleyball-api.com/people/23bf9fb8-bcc8-5ee0-14c4-f227d4081895.png",
"country": "Italy"
}
]
},
"timestamp": "2026-09-01 14:22:01"
}