> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sportsapipro.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 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`

```json theme={null}
{
  "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
```