# GET /v2/series

Group: Race sports

The race sports’ directory: the series of one category — Nascar → NASCAR Cup Series, Truck Series, Xfinity; Formula 1 → Formula 1; cycling’s International → Cycling Men, Cycling Women.

Note: A category without series (motorsport’s International, any fixture-sport category) is an empty list. Pass a series id to /v2/series/{id}/seasons, /races, /standings.

## Parameters

| Name | In | Required | Description |
| --- | --- | --- | --- |
| `category` | query | yes | a category id from /v2/categories?sport=motorsport or ?sport=cycling |

## Response

- `data`: `SeriesRef[]`
- `meta`: category, count
- Objects: SeriesRef (https://sportsapi.app/markdown/en/reference.md#seriesref)

## Errors

- 400 bad_request — missing or invalid category
- 404 not_found — a category id we never issued

Plus the common errors (https://sportsapi.app/markdown/en/docs.md#errors).

## Request

cURL:

```bash
curl -H "Authorization: Bearer sk_live_…" \
    "https://api.sportsapi.app/v2/series?category=…"
```

TypeScript:

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

Python:

```python
res = client.series.list(category=category)
```

Go:

```go
res, err := client.Series.List(ctx, &sportsapi.SeriesListParams{Category: category})
```

CLI:

```bash
$ sportsapi series list <category>
```

## Example response

```json
{ "data": [ { "id": 696772, "name": "NASCAR Cup Series", "slug": "nascar-cup-series", "sport": "motorsport" },
    { "id": 812301, "name": "NASCAR Craftsman Truck Series", "slug": "nascar-camping-world", "sport": "motorsport" }, … ],
  "meta": { "category": 696300, "count": 3 } }
```

---

Base URL: https://api.sportsapi.app. Send your API key as `Authorization: Bearer <key>` on every /v2 request; keys are created in the dashboard (https://sportsapi.app/dashboard).
HTML: https://sportsapi.app/docs/races/series-list · All docs: https://sportsapi.app/markdown/en/docs.md