Endpoint

Bookmakers

Return entitlement-scoped sources plus product coverage status. Bookmaker coverage varies by event and league and is not a per-event guarantee. Currently 0 product-verified bookmakers form the entitlement pool while every source is under review.

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/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.
limit
Pagination size 1–500 (default 50).
offset
Pagination offset, 0-based (default 0).
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": false,
        "liveAvailable": false,
        "coverageStatus": "disabled_until_review",
        "sourceMode": "direct",
        "lastVerifiedAt": "2026-10-01",
        "customerNote": "Tipico ingestion is offline for a source review and is not part of current customer coverage."
      }
    }
  ],
  "meta": {
    "total": 0,
    "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.