DocsAPI ReferenceMCPSDKs
AltSportsData
Data API (Sports Data)Competitions
Route Guide

Competition Details

Get detailed information about a competition including matches

Route Reference

Method, path, and environment

GETAuthenticate with X-API-Key
Full route
https://api.altsportsdata.com/api/v1/data/competitions/{competitionId}
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.

Path Parameters

competitionIdstringrequired

Competition identifier

Optional

Query Parameters

datestring

Filter by date (YYYY-MM-DD)

Optional
divisionstring

Filter by division: men, women, or mixed

men

Responses

200

OK

Response body

{
  "data": {
    "id": "comp-001",
    "name": "Event 1",
    "date": "2026-01-15",
    "matches": [
      {"id": "match-001", "round": 1, "teamA": "Team 1", "teamB": "Team 2", "status": "completed", "scoreA": 8, "scoreB": 5}
    ]
  }
}
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.

List Competitions

Get competitions for a specific season

Competition Events

Get lifecycle events for a competition