Endpoint

Bookmakers

Return entitlement-scoped sources plus product coverage status. Bookmaker coverage varies by event and league — the 14 product-verified bookmakers are the entitlement pool, not a per-event guarantee.

GET/api/v1/bookmakersAuth: Required

List entitled bookmaker sources with verified REST and live capability metadata.

Query / path parameters

sport
Sport code, defaults to football.
transport
rest (default) or live.
Request
curl "https://api.betspread.io/api/v1/bookmakers?sport=football&transport=rest" \
  -H "Authorization: Bearer $BETSPREAD_API_KEY"
Response
{
  "data": [
    {
      "slug": "tipico",
      "displayName": "Tipico",
      "coverage": {
        "region": "Germany / DACH",
        "countries": [
          "DE"
        ],
        "restAvailable": true,
        "liveAvailable": true,
        "coverageStatus": "verified_rest_live",
        "sourceMode": "direct",
        "lastVerifiedAt": "2026-05-20",
        "customerNote": "Verified REST and STOMP live output."
      }
    }
  ],
  "meta": {
    "total": 14,
    "limit": 50,
    "offset": 0,
    "sport": "football",
    "transport": "rest"
  }
}

Source coverage

Sources with status source_limited or live_beta are not returned from broad customer odds surfaces. Filtering with ?bookmaker= to a slug that is not product-verified for your sport and transport returns 403 forbidden.

Example

Each entry in data ships with a coverage object naming the region, countries, transport availability, source mode (direct vs. relay), and the date the source was last verified by product.