Sports API
The Sports API provides access to sports configuration and team information.Endpoints
| Method | Endpoint | Description |
|---|---|---|
GET | /v1/sports | Get all sports |
GET | /v1/sports/teams/provider | Get teams by provider |
Get Sports
Retrieve available sports and their configuration:Sport Fields
| Field | Type | Description |
|---|---|---|
sport | string | Sport name |
image | string | Sport image URL |
resolution | string | Resolution configuration |
ordering | string | Display ordering |
tags | string | Associated tags |
series | string | Associated series |
isOperational | boolean | Whether sport is operational |
automaticResolution | boolean | Whether automatic resolution is enabled |
Get Teams by Provider
Retrieve team information from a specific data provider:Parameters
| Parameter | Type | Description |
|---|---|---|
teamIds | array | Filter by team IDs |
provider | string | Data provider (PROVIDER_SPORTSDATAIO or PROVIDER_SPORTRADAR) |
league | string | League name (e.g., NFL, NBA, MLB) |
Team Fields
| Field | Type | Description |
|---|---|---|
id | integer | Team identifier |
name | string | Team name |
abbreviation | string | Team abbreviation |
displayAbbreviation | string | Display abbreviation |
league | string | League name |
record | string | Team record |
logo | string | Logo URL |
alias | string | Team alias |
safeName | string | Safe name for URLs |
homeIcon | string | Home icon URL |
awayIcon | string | Away icon URL |
colorPrimary | string | Primary team color |
ranking | integer | Team ranking |
conference | string | Conference name |
providerIds | array | Provider ID mappings |
Data Providers
| Provider | Description |
|---|---|
PROVIDER_SPORTSDATAIO | SportsData.io |
PROVIDER_SPORTRADAR | Sportradar |