Live, Schedule & Search Endpoints

14 endpoints for live volleyball games, schedules, search, and discovery

Live & Schedule (7 endpoints)

Live Games

GET /api/live

Curated live games with teams, scores, and set info.

Live (All)

GET /api/live/all

Raw live data for all volleyball games.

Today’s Games

GET /api/today

Schedule by Date

GET /api/schedule/:date

Date format: YYYY-MM-DD. Example: GET /api/schedule/2026-03-12

Live Tournaments

GET /api/live-tournaments

Leagues with live games right now.

Scheduled Tournaments

GET /api/scheduled-tournaments/:date

Leagues with games on a specific date.

Newly Added Events

GET /api/newly-added-events

Response Example — /api/live

{
  "events": [
    {
      "id": 12345678,
      "homeTeam": { "id": 3001, "name": "Brazil" },
      "awayTeam": { "id": 3002, "name": "Poland" },
      "homeScore": {
        "current": 2,
        "display": 2,
        "period1": 25,
        "period2": 21,
        "period3": 25,
        "period4": 0
      },
      "awayScore": {
        "current": 1,
        "display": 1,
        "period1": 23,
        "period2": 25,
        "period3": 20,
        "period4": 0
      },
      "status": { "code": 14, "description": "4th Set", "type": "inprogress" },
      "tournament": { "name": "FIVB World Championship", "id": 320 },
      "startTimestamp": 1737331200
    }
  ]
}

Score Fields

Field	Description
period1 – period5	Points scored in each set (sets to 25, 5th set to 15)
current	Sets won (0–3)
display	Sets won

Status Codes

Code	Description
0	Not started
11	1st Set
12	2nd Set
13	3rd Set
14	4th Set
15	5th Set
31	Set Break
100	Ended

---

Search & Discovery (7 endpoints)

Search

GET /api/search?q=brazil

Search teams, players, and tournaments.

Countries / Categories

GET /api/countries

Volleyball categories and countries (37 categories).

Countries (Extended)

GET /api/countries/all

Category Tournaments

GET /api/categories/:categoryId/tournaments

Leagues in a country/category.

Trending Players

GET /api/trending-players

Volleyball News

GET /api/news?lang=en

Country Flag

GET /api/country/:code/flag