Volleyball API
DocumentationLiveCoveragePricingMCPStatusSign inGet a free key

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.

PlansFree keyLiveArchiveComplete
Base URLhttps://api.volleyballapi.com
Answerone object

Parameters

This endpoint takes the parameters below.

NameTypeWhat it doesExample
idpathThe 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"

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

FieldTypeWhat it holds
idstringStable team id, tm_
namestringThe name it plays under
disciplineenumindoor or beach
genderenummen, women or mixed
kindenumclub, national or pair
federationstringThree-letter federation code, for national teams and pairs
country_codestringTwo-letter country the team plays for, or null where it is not certain
playersarrayid 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.

HTTPCodeWhen
401unauthorizedNo key, or a key that is not known or was revoked
404not_foundAn id that does not exist
422unknown_parameterA parameter this endpoint does not take; the answer lists the ones it does
429rate_limitedToo many calls this minute; Retry-After says when to try again
429quota_exceededThe 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.