Endpoint

Sports

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

Examples use Tipico for illustration only. Tipico ingestion is offline for a source review and is not part of current customer coverage.

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.
limit
Pagination size 1–500 (default 50).
offset
Pagination offset, 0-based (default 0).
Request
curl "https://api.betspread.io/api/v1/sports" \
  -H "Authorization: Bearer $BETSPREAD_API_KEY"
Response
{
  "data": [
    {
      "slug": "football",
      "name": "Football",
      "coverage": {
        "transport": "rest",
        "bookmakerCount": 1,
        "bookmakers": [
          {
            "slug": "tipico",
            "displayName": "Tipico",
            "coverageStatus": "disabled_until_review",
            "restAvailable": false,
            "liveAvailable": false,
            "lastVerifiedAt": "2026-10-01"
          }
        ]
      }
    }
  ],
  "meta": {
    "total": 1,
    "limit": 50,
    "offset": 0,
    "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.