V2 Reference

List all sportsbooks/affiliates

Changed on

Returns currently published sportsbook IDs, names, URLs and overall status. With sport_id, status is sport-scoped and status_scope is sport. include=sports adds sport_id, status and since for each stored sport row; combine with include=regions. Responses without parameters are unchanged. Status data is cached for up to 15 seconds. Treat unknown status values as unknown. Health labels do not filter odds. No authentication required.

get/api/v2/affiliates

Request

  • Base URL
    https://therundown.io
  • Auth
    none required

Query parameters

includestring[]

Optional regions and/or sports; combine as include=regions,sports or repeat the parameter.

sport_idinteger

One positive sport ID. Scopes each affiliate status to that sport and adds status_scope=sport. A missing sport row is unhealthy until proved, except held books remain healthy and beta books remain beta. Unknown positive IDs are accepted. Does not filter affiliates or sports[]. Empty, repeated, non-integer or out-of-range IDs return 400.

Response

List of affiliates

Example response

{
  "affiliates": [
    {
      "affiliate_id": 19,
      "affiliate_name": "Draftkings",
      "affiliate_url": "https://draftkings.com",
      "status": "healthy"
    }
  ]
}

Changes

    • breaking

      removed the enum value regions from the query request parameter include

    • breaking

      for the query request parameter include, the type changed from string to array

    • info

      added the new optional query request parameter sport_id

    • info

      added the non-success response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status