List competitions
Returns only the selectable competitions in the authenticated Starter client's persistent selection.
Request
GET
/v1/leagues
| Plan | Authentication | Cache | Units | Rows |
|---|---|---|---|---|
| Starter | X-API-Key | Private, 60 seconds; ETag and If-None-Match supported. | 1 | 0 |
Parameters
No endpoint-specific parameters.
Example
curl -sS https://api.foresportia.com/v1/leagues \
-H "X-API-Key: $FORESPORTIA_API_KEY"Response
{
"source": "Foresportia",
"data_version": "eeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee",
"leagues": [
{
"code": "FIN",
"name": "Veikkausliiga",
"country": "Finland",
"catalog_status": "selectable",
"activity_status": "active",
"available": true,
"matches_available": 4
},
{
"code": "BEL",
"name": "Belgian Pro League",
"country": "Belgium",
"catalog_status": "selectable",
"activity_status": "unavailable",
"available": false,
"matches_available": 0
}
]
}Errors and limits
- 401 missing or invalid API key
- 403 invalid plan contract
- 429 quota or concurrency limit
- 503 Starter store unavailable
See Errors for the full list, and Quotas for the limits that apply to every route.