Events
Fetch all events
Fetch all events
Endpoint overview
Fetch all events across sports, leagues, and statuses with optional date and filter constraints.
Use case: build a daily event board that lists upcoming events between a start and end date.
Route
GET /api/v1/public/eventsParameters (Overview)
| Name | In | Type | Required | Description |
|---|---|---|---|---|
startDate | query | string | No | — |
endDate | query | string | No | — |
sportType | query | string | No | Filter events for a specific type of sport. |
sortOrder | query | string | No | Order in which the results should be sorted |
eventStatus | query | array | No | Event statuses for which to return results. |
GETHTTP Method
Return event listings across supported sports.
Parameters for Example Query
Edit path and query inputs below. These values auto-fill from the schema and immediately update the request URL and generated code examples.
Response Body
application/json
application/json
application/json
application/json
application/json
Updated recently
Language
Credentials
X-API-KEY
Try it runs a real request through this site's proxy (avoids CORS). Pasting your key updates the cURL tab and is sent on Try it.
URL
Base URL
https://api.altsportsdata.com
curl -X GET "https://api.altsportsdata.com/api/v1/public/events?startDate=2026-03-24T17%3A39%3A34Z&endDate=2026-04-07T17%3A39%3A34Z"Click Try it to send the active example request.
Response static example
[
{
"id": "wsl:636d414b-8d24-49d2-a9d8-57ec650a4e0e",
"numericEventId": 1174117206190029,
"name": "Billabong Pro Pipeline",
"sportLogo": "https://assets.altsportsdata.com/public/images/sports/wsl.png",
"tourName": "World Surf League",
"startDate": "2024-04-18T15:25:24Z",
"endDate": "2024-04-20T15:25:24Z",
"year": 2024,
"eventNumber": 3,
"eventStatus": "UPCOMING",
"eventLocation": "Oahu, Hawaii, USA",
"eventLocationNumericId": 1174117206190034,
"eventLocationGroup": "Pipeline",
"providerId": "evt_pipeline_2024",
"updatedAt": "2024-04-16T10:00:00Z"
}
]{
"message": "string",
"statusCode": 0,
"timestamp": "string"
}{
"message": "string",
"statusCode": 0,
"timestamp": "string"
}{
"message": "string",
"statusCode": 0,
"timestamp": "string"
}{
"message": "string",
"statusCode": 0,
"timestamp": "string"
}