> ## Documentation Index > Fetch the complete documentation index at: https://docs.therundown.io/llms.txt > Use this file to discover all available pages before exploring further. # List all sports ## OpenAPI ````yaml get /api/v1/sports openapi: 3.1.0 info: title: TheRundown Sports API version: 2.0.0 description: > **Resolve the event first.** Ambiguous date, team, player, or timezone? The agent asks instead of guessing. **Every price carries evidence.** Event, market, affiliate ID, line, and the price update time. A fetch time is not freshness. **Missing stays missing.** No remembered odds, no synthetic prices, no filled gaps. **IDs come from the API.** Sports, markets, and affiliates are discovered at runtime. Retired affiliates stay out. Real-time and historical sports betting data, odds, lines, and statistics across major North American and international sports leagues. ## Authentication All endpoints (except `/sports` and `/affiliates`) require authentication. Send your API key from a private server-side environment variable in the `X-TheRundown-Key` header. The query-key security scheme is retained for compatibility with existing integrations and deprecated for new integrations; do not put keys in URLs, prompts, browser bundles, or public code. ## Off-the-Board Sentinel Value The value **0.0001** indicates a line is "off the board" — the sportsbook has temporarily removed pricing (e.g., pending injury news). This is NOT an error. Display as "Off Board" or "N/A" in your UI. ## Rate Limiting Requests are rate-limited per API key tier. Check response headers for current limits. ## Data Updates - Live odds update in real-time during games - Use delta endpoints for efficient polling of changes - WebSocket connections available for streaming updates ## V1 vs V2 V2 endpoints use market-based data structures (market_id, participants, line prices). V1 endpoints use legacy line-based structures (moneyline, spread, total objects). V2 is recommended for new integrations. contact: name: TheRundown API Support url: https://therundown.io email: support@therundown.io termsOfService: https://therundown.io/terms servers: - url: https://therundown.io description: Production security: - ApiKeyHeader: [] tags: - name: V2 Sports description: Sport listings, dates, and teams (V2) - name: V2 Events description: Events with market-based odds (V2) - name: V2 Markets description: Market definitions, odds, deltas, and history (V2) - name: V2 Futures description: >- Futures/outright competition events — championship and tournament-winner boards (V2, early access) - name: V2 Teams description: Team data, players, and stats (V2) - name: V2 Players description: Player data (V2) - name: V2 Stats description: Team and player statistics (V2) - name: V2 WebSocket description: Real-time streaming via WebSocket (V2) - name: V2 Reference description: Reference data — affiliates, sportsbooks, season types (V2) - name: V1 Events description: Events with line-based odds (V1 legacy) - name: V1 Lines description: Moneyline, spread, total, best-line endpoints (V1 legacy) - name: V1 Sports description: Sport listings, dates, events, schedules (V1 legacy) - name: V1 Delta description: Delta/change feeds (V1 legacy) - name: V1 Reference description: Reference data (V1 legacy) - name: V1 WebSocket description: Real-time streaming via WebSocket (V1 legacy) externalDocs: description: Build with AI guide url: https://therundown.io/build-with-ai paths: /api/v1/sports: get: tags: - V1 Sports summary: List all sports operationId: v1GetSports responses: '200': description: List of sports content: application/json: schema: $ref: '#/components/schemas/SportsResponse' example: sports: - sport_id: 1 sport_name: NCAA Football - sport_id: 2 sport_name: NFL - sport_id: 3 sport_name: MLB - sport_id: 4 sport_name: NBA - sport_id: 5 sport_name: NCAA Men's Basketball - sport_id: 6 sport_name: NHL - sport_id: 7 sport_name: UFC/MMA - sport_id: 8 sport_name: WNBA - sport_id: 10 sport_name: MLS - sport_id: 11 sport_name: EPL - sport_id: 12 sport_name: FRA1 - sport_id: 13 sport_name: GER1 - sport_id: 14 sport_name: ESP1 - sport_id: 15 sport_name: ITA1 - sport_id: 16 sport_name: UEFACHAMP - sport_id: 17 sport_name: UEFAEURO - sport_id: 18 sport_name: FIFA - sport_id: 19 sport_name: JPN1 - sport_id: 20 sport_name: IPL - sport_id: 21 sport_name: T20 - sport_id: 22 sport_name: Politics - sport_id: 23 sport_name: NBA Preseason - sport_id: 24 sport_name: NBA Playoffs - sport_id: 25 sport_name: NFL Preseason - sport_id: 26 sport_name: NFL Playoffs - sport_id: 27 sport_name: NHL Preseason - sport_id: 28 sport_name: NHL Playoffs - sport_id: 30 sport_name: MLB Spring Training - sport_id: 31 sport_name: MLB Playoffs - sport_id: 32 sport_name: NBA Summer League - sport_id: 33 sport_name: UEFA Europa League - sport_id: 38 sport_name: TENNIS.ATP - sport_id: 39 sport_name: TENNIS.WTA security: [] components: schemas: SportsResponse: type: object properties: sports: type: array items: $ref: '#/components/schemas/Sport' Sport: type: object properties: sport_id: type: integer example: 4 sport_name: type: string example: NBA securitySchemes: ApiKeyHeader: type: apiKey in: header name: X-TheRundown-Key description: Recommended API key request header for new integrations ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.