DocumentationTeams and players
Volleyball team API
GET/v1/teams/{id}
One team with its kind, discipline, gender and federation, and the players it has fielded.
Parameters
This endpoint takes the parameters below.
| Name | Type | What it does | Example |
|---|---|---|---|
id | path | The team id, in the address. Required. | tm_rk2hqqay |
Request
Send your key in the Authorization header as a Bearer token, or in X-API-Key. A key in the address is refused, so it never ends up in a log.
# One team: its name, kind, federation and players curl "https://api.volleyballapi.com/v1/teams/tm_rk2hqqay" \ -H "Authorization: Bearer $VBA_KEY"
$ch = curl_init('https://api.volleyballapi.com/v1/teams/tm_rk2hqqay'); 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/teams/tm_rk2hqqay", headers={"Authorization": f"Bearer {os.environ['VBA_KEY']}"}, ) print(r.json()["data"])
const res = await fetch("https://api.volleyballapi.com/v1/teams/tm_rk2hqqay", { headers: { "X-API-Key": process.env.VBA_KEY }, }); const { data, meta } = await res.json();
Response
Every answer is data plus meta. This is a real answer to the request above, counted 2026-10-12, with long lists cut short.
200 application/json
{
"data": {
"id": "tm_rk2hqqay",
"name": "Korea",
"discipline": "indoor",
"gender": "women",
"kind": "national",
"federation": "KOR",
"country_code": "KR",
"players": []
},
"meta": { "plan": "Complete" }
}Fields
| Field | Type | What it holds |
|---|---|---|
id | string | Stable team id, tm_ |
name | string | The name it plays under |
discipline | enum | indoor or beach |
gender | enum | men, women or mixed |
kind | enum | club, national or pair |
federation | string | Three-letter federation code, for national teams and pairs |
country_code | string | Two-letter country the team plays for, or null where it is not certain |
players | array | id and name of each player the team has fielded |
Errors
Errors come back as {"error": {"code", "message", "docs"}}, with plan and pricing added when a plan would answer. Every error.
| HTTP | Code | When |
|---|---|---|
| 401 | unauthorized | No key, or a key that is not known or was revoked |
| 404 | not_found | An id that does not exist |
| 422 | unknown_parameter | A parameter this endpoint does not take; the answer lists the ones it does |
| 429 | rate_limited | Too many calls this minute; Retry-After says when to try again |
| 429 | quota_exceeded | The day's or month's allowance is used; the answer says when it resets |
Try it
Fill in what you need; the request is built as you type. Paste your key to run it here, straight against the API.