---
title: "List all sportsbooks/affiliates"
method: GET
path: "/api/v1/affiliates"
tags: ["V1 Reference"]
---

# List all sportsbooks/affiliates

`GET /api/v1/affiliates`

## Request

- Base URL: `https://therundown.io`
- URL: `https://therundown.io/api/v1/affiliates`
- Auth: none required

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.

## Query parameters

- `include` string[]
- `sport_id` integer

## Response `200`

List of affiliates

- AffiliatesResponse
  - `affiliates` Affiliate[]
    - `affiliate_id` integer
    - `affiliate_name` string
    - `affiliate_url` string
    - `status` string: Overall book health unless status_scope is sport. Current values are healthy, unhealthy and beta; treat unknown values as unknown.
    - `status_scope` 'sport': Present only when sport_id scopes status to one sport.
    - `sports` AffiliateSportStatus[]: Stored per-sport health rows, present only with include=sports. An empty array means no stored sport proof, not healthy coverage.
      - `sport_id` integer, required: Sport identifier.
      - `status` string, required: Sport health / rollout status; treat unrecognized values as unknown.
      - `since` string, date-time, nullable, required: UTC timestamp of the last status change; null when unavailable.
    - `regions` Region[]
      - `id` integer
      - `name` string

## Other responses

- `400`: Invalid sport_id; supply exactly one positive integer.

## Changes

- **2026-10-27** `b9aaece5ac2f`: 2 breaking, 4 info
  - removed the enum value `regions` from the `query` request parameter `include`
  - for the `query` request parameter `include`, the type changed from `string` to `array`
  - added the new optional `query` request parameter `sport_id`
  - added the non-success response with the status `400`
  - …2 more

[Operation history](https://skmtc.dev/therundown/apis/therundown-sports-api/changes/api/v1/affiliates/get.md)

---

[API](https://skmtc.dev/therundown/apis/therundown-sports-api.md) - [All operations](https://skmtc.dev/therundown/apis/therundown-sports-api/llms.txt) - [OpenAPI document](https://skmtc.dev/therundown/apis/therundown-sports-api/revisions/b1735c57a340?raw)