DocsAPI ReferenceMCPSDKs
AltSportsData
Public API (Betting & Odds)Events
Route Guide

List Events

Retrieve a list of sports events with filtering by sport type, date range, and event status.

Route Reference

Method, path, and environment

GETAuthenticate with X-API-Key
Full route
https://api.altsportsdata.com/api/v1/public/events
Base URL
https://api.altsportsdata.com
Testing Flow

Use the right pane to validate the route

01

Choose a language and confirm the environment or base URL.

02

Paste your API key, then fill in path or query parameters.

03

Run the request and inspect the live response without leaving this page.

Query Parameters

startDatestring

Filter events starting from this date (ISO 8601)

Optional
endDatestring

Filter events up to this date (ISO 8601)

Optional
sportTypestring

Filter by sport type (see enum below)

f1
sortOrderstring

Sort order: ASC or DESC (default: DESC)

Optional
eventStatusarray

Filter by event status (multiple allowed)

UPCOMING

Responses

200

OK

Response body

{
  "data": [
    {
      "id": "f1-bahrain-gp-2026",
      "name": "Bahrain Grand Prix",
      "sportType": "f1",
      "eventStatus": "UPCOMING",
      "startDate": "2026-03-15T15:00:00Z",
      "endDate": "2026-03-15T17:00:00Z",
      "venue": {
        "name": "Bahrain International Circuit",
        "location": "Sakhir, Bahrain"
      },
      "participants": 20,
      "marketsAvailable": 15
    }
  ]
}
400

One of the request parameters is invalid. See the returned message for details.

401

Authentication headers are missing or invalid. Make sure you authenticate your request with a valid API key.

403

The requested resource is forbidden.

429

Too many requests. You hit the rate limit. Use the X-RateLimit headers to confirm when you can retry.

500

Internal server error. Retry later, and contact support if the issue persists.

OpenAPI Specification

Download and reference the AltSportsData OpenAPI 3.0 specification

Get Event

Fetch detailed information about a specific event