Discovery

Categories

GET/v2/categoriesAll plans
View as MarkdownTry in Playground →

A sport’s categories: the source’s grouping of leagues — countries, regions (Europe, International), tours (ATP), esports games.

country is set only when the category is a country. Pass a category id to /v2/leagues?category= — or, when kind is races (motorsport, cycling), to /v2/series?category=: race sports have series, not leagues.

Parameters

sport
queryrequired
a sport slug from /v2/sports

Response

data
Category[]
meta
sport, kind (fixtures | races, as in /v2/sports), count
errors
400 bad_request — missing or unknown sport

Every /v2 call can also answer the common errors.

Try it →
$ curl -H "Authorization: Bearer sk_live_…" \
    "https://api.sportsapi.app/v2/categories?sport=…"
Example
{ "data": [ { "id": 456, "name": "England", "slug": "england", "sport": "football", "country": { "code": "EN", "name": "England" } },
    { "id": 457, "name": "Oceania", "slug": "oceania", "sport": "football", "country": null }, … ],
  "meta": { "sport": "football", "kind": "fixtures", "count": 272 } }