# GET /v2/sports

Group: Catalog

Lists all supported sports, each with the number of matches live right now. Matches the source has left open — 45 min without any change, with a kick-off further back than a match in that sport could run — do not count towards it. kind tells you which endpoint family serves the sport: fixtures, for sports served by the Fixtures, Teams and Leagues endpoints; races, for motorsport and cycling, which the Race sports endpoints cover (their fixture lists stay empty).

Plans: Every plan, Free included.

## Response

- `data`: `{ slug: string; name: string; kind: "fixtures" | "races"; live: number }[]`
- `meta`: count

## Errors

Plus the common errors (https://datasportsapi.com/markdown/docs.md#errors).

## Request

cURL:

```bash
curl -H "Authorization: Bearer sk_live_…" \
    "https://api.datasportsapi.com/v2/sports"
```

TypeScript:

```ts
const { data, meta } = await client.sports.list();
```

Python:

```python
res = client.sports.list()
```

Go:

```go
res, err := client.Sports.List(ctx)
```

CLI:

```bash
$ dsa sports list
```

## Example response

```json
{ "data": [ { "slug": "football", "name": "Football", "kind": "fixtures", "live": 42 }, { "slug": "ice-hockey", "name": "Ice hockey", "kind": "fixtures", "live": 9 }, …,
    { "slug": "motorsport", "name": "Motorsport", "kind": "races", "live": 0 } ],
  "meta": { "count": 24 } }
```

---

Base URL: https://api.datasportsapi.com. Authenticate each /v2 call with the header `Authorization: Bearer <key>` (secret keys begin with `sk_live_`).
HTML: https://datasportsapi.com/docs/catalog/sports-list/ · All docs: https://datasportsapi.com/markdown/docs.md · Data reference: https://datasportsapi.com/markdown/reference.md
