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

> Darts V2 live scores, schedules, search, and discovery

## Live & Schedule Endpoints (7)

All endpoints use base URL `https://api.sportsapipro.com/v2/darts`.

```bash theme={null}
GET /api/live                           # Curated live matches
GET /api/live/all                       # Raw live data
GET /api/today                          # Today's scheduled matches
GET /api/schedule/:date                 # Schedule by date (YYYY-MM-DD)
GET /api/live-tournaments               # Tournaments with live matches
GET /api/scheduled-tournaments/:date    # Tournaments with matches on date
GET /api/newly-added-events             # Recently added matches
```

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

```json theme={null}
{
  "events": [
    {
      "id": 12345678,
      "homeTeam": { "id": 6601, "name": "Luke Humphries" },
      "awayTeam": { "id": 6602, "name": "Michael van Gerwen" },
      "homeScore": {
        "current": 4,
        "display": 4,
        "period1": 3,
        "period2": 2,
        "period3": 3,
        "period4": 1,
        "period5": 3
      },
      "awayScore": {
        "current": 3,
        "display": 3,
        "period1": 1,
        "period2": 3,
        "period3": 1,
        "period4": 3,
        "period5": 2
      },
      "status": { "code": 16, "description": "6th Set", "type": "inprogress" },
      "tournament": { "name": "PDC World Championship", "id": 740 },
      "startTimestamp": 1737331200
    }
  ]
}
```

### Score Fields

| Field      | Description          |
| ---------- | -------------------- |
| `period1`+ | Legs won in each set |
| `current`  | Sets won             |

<Note>Darts scoring varies by format: some events use sets (best of legs per set), others use a straight leg format. The `period` fields represent legs per set in set-based events, or individual legs in leg-based events.</Note>

## Search & Discovery Endpoints (7)

```bash theme={null}
GET /api/search?q=van+gerwen            # Search players, tournaments
GET /api/countries                      # Categories (England=261, International=104)
GET /api/countries/all                  # Extended categories
GET /api/categories/:categoryId/tournaments  # Tournaments in category
GET /api/trending-players               # Trending darts players
GET /api/news?lang=en                   # Darts news
GET /api/country/:code/flag             # Country flag URL
```

### Example: Find Live Matches

```bash theme={null}
curl -H "x-api-key: YOUR_API_KEY" \
  https://api.sportsapipro.com/v2/darts/live
```

### Example: Browse PDC Tournaments

```bash theme={null}
curl -H "x-api-key: YOUR_API_KEY" \
  "https://api.sportsapipro.com/v2/darts/categories/261/tournaments"
```