> ## 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 American Football V2 global endpoints for live data, scheduling, and search

# Live & Schedule Endpoints (7)

| Method | Endpoint                           | Description                                           |
| ------ | ---------------------------------- | ----------------------------------------------------- |
| GET    | `/api/live`                        | Curated live games (with teams, scores, quarter info) |
| GET    | `/api/live/all`                    | Raw live data                                         |
| GET    | `/api/today`                       | Today's scheduled games                               |
| GET    | `/api/schedule/:date`              | Schedule by date (YYYY-MM-DD)                         |
| GET    | `/api/live-tournaments`            | Leagues with live games now                           |
| GET    | `/api/scheduled-tournaments/:date` | Leagues with games on a date                          |
| GET    | `/api/newly-added-events`          | Recently added games                                  |

<Note>
  NFL runs September–February. During the off-season (March–August), live and today endpoints return 0 events.
</Note>

### Response Example — `/api/live`

```json theme={null}
{
  "events": [
    {
      "id": 12345678,
      "homeTeam": { "id": 4388, "name": "Kansas City Chiefs" },
      "awayTeam": { "id": 4389, "name": "Philadelphia Eagles" },
      "homeScore": {
        "current": 24,
        "display": 24,
        "period1": 7,
        "period2": 10,
        "period3": 7,
        "period4": 0
      },
      "awayScore": {
        "current": 17,
        "display": 17,
        "period1": 3,
        "period2": 7,
        "period3": 0,
        "period4": 7
      },
      "status": { "code": 14, "description": "4th Quarter", "type": "inprogress" },
      "tournament": { "name": "NFL", "id": 9464 },
      "season": { "id": 58032 },
      "startTimestamp": 1737331200
    }
  ]
}
```

### Score Fields

| Field                 | Description                     |
| --------------------- | ------------------------------- |
| `period1` – `period4` | Points scored in Q1–Q4          |
| `overtime`            | Overtime points (if applicable) |
| `current`             | Total points so far             |
| `display`             | Display score (same as current) |

### Status Codes

| Code | Description            |
| ---- | ---------------------- |
| 0    | Not started            |
| 11   | 1st Quarter            |
| 12   | 2nd Quarter            |
| 13   | Halftime               |
| 14   | 3rd Quarter            |
| 15   | 4th Quarter            |
| 31   | Halftime               |
| 40   | Overtime               |
| 100  | Ended                  |
| 110  | Ended (after overtime) |

# Search & Discovery Endpoints (7)

| Method | Endpoint                                  | Description                        |
| ------ | ----------------------------------------- | ---------------------------------- |
| GET    | `/api/search?q=chiefs`                    | Search teams, players, tournaments |
| GET    | `/api/countries`                          | Categories (USA, Canada, etc.)     |
| GET    | `/api/countries/all`                      | Extended categories                |
| GET    | `/api/categories/:categoryId/tournaments` | Leagues in a category              |
| GET    | `/api/trending-players`                   | Trending players                   |
| GET    | `/api/news?lang=en`                       | American football news             |
| GET    | `/api/country/:code/flag`                 | Country flag URL                   |