Competitions
List available competitions (FIFA World Cup seasons) and retrieve details for a single competition.
List competitions
Returns a paginated list of all competitions.
GET/api/public/v1/competitions
Query parameters
| Parameter | Type | Description |
|---|---|---|
| page optional | integer | Page number. Default: 1. |
| per_page optional | integer | Results per page. Default: 20, max: 100. |
Example request
http
GET /api/public/v1/competitions Authorization: Bearer sk_live_xxxxxxxxxxxxx
Example response
json
{
"data": [
{
"id": "season_UCUznkuK",
"name": "FIFA World Cup 2026",
"year": 2026,
"host": "USA/Mexico/Canada",
"type": "international"
},
{
"id": "season_ab3kQ2",
"name": "FIFA World Cup 2022",
"year": 2022,
"host": "Qatar",
"type": "international"
}
],
"meta": { "page": 1, "per_page": 20, "total": 3 }
}Get competition
Returns a single competition by its public ID.
GET/api/public/v1/competitions/:id
Path parameters
| Parameter | Type | Description |
|---|---|---|
| id required | string | Competition public ID (e.g. season_UCUznkuK). |
Example request
http
GET /api/public/v1/competitions/season_UCUznkuK Authorization: Bearer sk_live_xxxxxxxxxxxxx
Example response
json
{
"data": {
"id": "season_UCUznkuK",
"name": "FIFA World Cup 2026",
"year": 2026,
"host": "USA/Mexico/Canada",
"type": "international"
}
}