API ReferencePublic API (Betting & Odds)Events

List Events

Fetch all events with filtering options

Endpoint overview

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

Route

GET/api/v1/public/events

Authentication

Required. Use `X-API-KEY` header.

Query Parameters

Use query parameters to refine the result set. Changes here update the request URL and example request in the right panel immediately.

startDatestringoptional

Filter events starting from this date (ISO 8601)

endDatestringoptional

Filter events up to this date (ISO 8601)

sportTypestringoptional

Filter by sport type (see enum below)

Default: f1

sortOrderstringoptional

Sort order: ASC or DESC (default: DESC)

eventStatusarrayoptional

Filter by event status (multiple allowed)

Default: UPCOMING

Responses

Example Response

{
  "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
    }
  ]
}

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

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

403The requested resource is forbidden.

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

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

Live API test

GET

Same try-it pattern as OpenAPI reference pages — requests use this site's proxy to avoid CORS.

Language

Enter credentials

URL

https://api.altsportsdata.com/api/v1/public/events?sportType=f1&eventStatus=UPCOMING

Shell Request

curl -X GET "https://api.altsportsdata.com/api/v1/public/events?sportType=f1&eventStatus=UPCOMING" \
  -H "X-API-KEY: YOUR_API_KEY" \
  -H "Accept: application/json"

Response

Click Try it to send a request and see the response here.