---
title: "List available sports"
method: GET
path: "/v1/sports"
tags: ["Sports"]
---

# List available sports

`GET /v1/sports`

## Request

- Base URL: `https://api.puntersedge.online`
- URL: `https://api.puntersedge.online/v1/sports`
- Auth: API key in header `X-API-Key`

Cost: 1 credit. Returns the active sports catalogue as an array of objects containing key, title, group and active fields.

Racing is not in this catalogue. Horse, harness and greyhound racing have their own
endpoints: GET /v1/racing/next-to-go and GET /v1/racing/events.

## Headers

- `X-API-Key` string
- `X-RapidAPI-Proxy-Secret` string

## Response `200`

Successful Response

- SportOut[]
  - `key` string, required
  - `title` string, required
  - `group` string, nullable, required
  - `active` boolean, required
  - `cached` boolean, nullable
  - `cache_age_seconds` integer, nullable
  - `canonical_event_id` string, nullable
  - `data_quality` object, nullable

## Other responses

- `401`: Missing or invalid API key. Send `X-API-Key`. See https://puntersedge.online/developers/errors
- `402`: Monthly credit allowance exhausted for this plan. Upgrade at https://puntersedge.online/api/pricing
- `422`: Validation Error
- `429`: Rate limit exceeded for this plan. Honour the `Retry-After` header (seconds) before retrying. See https://puntersedge.online/developers/rate-limits
- `500`: Unexpected server error. Safe to retry with backoff.

---

[API](https://skmtc.dev/puntersedge/apis/puntersedge-odds-api.md) · [All operations](https://skmtc.dev/puntersedge/apis/puntersedge-odds-api/llms.txt) · [OpenAPI document](https://skmtc.dev/puntersedge/apis/puntersedge-odds-api/revisions/f35b6aab1946?raw)