Endpoint

Sports

Discover which sports your key can read. Start here before listing bookmakers or events.

GET/api/v1/sportsAuth: Required

List sports with at least one product-verified, entitled bookmaker. Start here to discover what is available to your key.

Query / path parameters

transport
Product channel: rest (default) or live. Live requires plan entitlement; otherwise returns 403 live_not_enabled.
Request
curl "https://api.betspread.io/api/v1/sports" \
  -H "Authorization: Bearer $BETSPREAD_API_KEY"
Response
{
  "data": [
    { "slug": "football", "displayName": "Football" }
  ],
  "meta": { "total": 1, "transport": "rest" }
}

Example

The response contains every sport with at least one verified bookmaker entitled to your organisation. During controlled beta this will return football only for most accounts.