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

# Darts V2 API Overview

> Enhanced Darts API: 90 endpoints for PDC, Premier League Darts, and Modus Super Series

## Base URL

```
https://api.sportsapipro.com/v2/darts
```

## Authentication

All requests require an `x-api-key` header:

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

## Darts-Specific Notes

* **Individual sport** — "teams" represent individual players (1v1 format)
* **501 format** — players start at 501 and throw to reduce to exactly 0 (must finish on a double)
* **Scoring**: Legs → Sets → Match
  * **Leg**: A single game of 501 — first to reach 0 wins
  * **Set**: Best of X legs (usually best of 5 = first to 3 legs)
  * **Match**: Best of X sets (varies by tournament round)
* **Score fields** use `period1` through `periodN` (representing sets)
* **Categories** are primarily **England** (ID: 261, PDC events) and **International** (ID: 104)
* **Key statistics**: 3-dart average, 180s, checkout %, highest checkout, 100+/140+ counts

## Key Darts Statistics

| Stat             | Description                       | Elite Level          |
| ---------------- | --------------------------------- | -------------------- |
| 3-dart average   | Average points per 3 darts        | 100+                 |
| 180s             | Maximum score per visit (T20 × 3) | High volume          |
| Checkout %       | Success rate finishing a leg      | 40%+                 |
| Highest checkout | Best finish in a leg (max: 170)   | 170 = T20, T20, Bull |

## Endpoint Categories

| Category             | Count  | Description                         |
| -------------------- | ------ | ----------------------------------- |
| Live & Schedule      | 7      | Live scores, schedules              |
| Search & Discovery   | 7      | Search, categories, news            |
| Tournament           | 19     | Tournament data, seasons, standings |
| Match                | 22     | Match details, stats, odds          |
| Team / Player Entity | 11     | Player profiles (as "teams")        |
| Player               | 16     | Individual player data              |
| Referee & Venue      | 8      | Callers and venues                  |
| **Total**            | **90** |                                     |

## Example Requests

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

  ```javascript JavaScript theme={null}
  const response = await fetch(
    'https://api.sportsapipro.com/v2/darts/live',
    { headers: { 'x-api-key': 'YOUR_API_KEY' } }
  );
  const data = await response.json();
  ```

  ```python Python theme={null}
  import requests

  response = requests.get(
      'https://api.sportsapipro.com/v2/darts/live',
      headers={'x-api-key': 'YOUR_API_KEY'}
  )
  data = response.json()
  ```
</CodeGroup>

## UI Design Ideas

* **Score display**: Show sets and legs — "Van Gerwen 7-5 Price (Sets)" with current leg score underneath
* **Live scoring**: Show remaining points per player (e.g., "141 remaining")
* **180 counter**: Prominent display — fans love this stat
* **3-dart average**: THE key performance metric — show prominently
* **Checkout highlights**: High checkouts (100+) are exciting moments
* **Tournament bracket**: Use `/knockout` for draw bracket — critical for major tournaments
* **H2H**: Important — use `/match/{id}/h2h`
* **Daily Modus Super Series**: 50-100+ matches/day on weekdays
* **PDC calendar**: World Championship (Dec-Jan), Premier League (Feb-May), World Matchplay (Jul)

## Darts Scoring Explained

* **501 format**: Players start at 501 and throw to reduce to exactly 0 (must finish on a double)
* **Leg**: A single game of 501 — player who reaches 0 first wins
* **Set**: Best of X legs (usually best of 5 = first to 3 legs)
* **Match**: Best of X sets (varies by tournament round)

## Sport Comparison — Darts vs Football vs Tennis

| Feature          | Darts                                      | Football            | Tennis           |
| ---------------- | ------------------------------------------ | ------------------- | ---------------- |
| Match format     | Best of X sets (each set = best of Y legs) | 2 × 45 min          | Best of 3/5 sets |
| Scoring          | Sets & legs (e.g., 7-5 in sets)            | Goals (0-5 typical) | Games/sets       |
| Score fields     | period1-periodN (sets)                     | period1-period2     | period1-period5  |
| Key stats        | 3-dart average, 180s, checkout %           | Goals, assists      | Aces, winners    |
| Players per side | 1 (individual)                             | 11                  | 1                |
| Duration         | 20 min - 3+ hours                          | \~90 min            | 1-5 hours        |
| Categories       | England, International                     | Countries           | Countries        |