API Documentation

Complete API reference for FIFA World Cup 2026 data. All endpoints return JSON format only.

Download Postman Collection

Import all API endpoints into Postman for easy testing

Download Collection Download Translations Collection

Authentication

All API requests require authentication using your API key. Include it as a query parameter:

?key=YOUR_API_KEY

You can find your API key in your dashboard after registration.

Live Scores

GET /livescores

Get live scores for all ongoing World Cup matches.

📖 View Detailed Documentation →

Parameters:

key (required) - Your API key
lang (optional) - Language code (es, fr, de, etc.) - defaults to English

Example Request:

GET /livescores?key=YOUR_API_KEY

Fixtures

GET /fixtures

Get all scheduled World Cup matches. Filter by date if needed.

📖 View Detailed Documentation →

Parameters:

key (required) - Your API key
date (optional) - Filter by date (YYYY-MM-DD format)
lang (optional) - Language code (es, fr, de, etc.) - defaults to English
group (optional) - Filter by specific group (A, B, C, etc.)
page (optional) - Page number (default: 1)
team_id (optional) - The team ID

Example Request:

GET /fixtures?key=YOUR_API_KEY&date=2026-06-15

Commentary

GET /commentary

Get detailed match events and commentary for a specific World Cup match.

📖 View Detailed Documentation →

Parameters:

key (required) - Your API key
match_id (required) - The match ID
lang (optional) - Language code (es, fr, de, etc.) - defaults to English
from (optional) - The second from which to start the commentary
to (optional) - The second to which to end the commentary

Example Request:

GET /commentary?key=YOUR_API_KEY&match_id=12345

Match Events

GET /events

Get all events (goals, cards, substitutions, etc.) for a specific match.

📖 View Detailed Documentation →

Parameters:

key (required) - Your API key
match_id (required) - The match ID
lang (optional) - Language code (es, fr, de, etc.) - defaults to English

Example Request:

GET /events?key=YOUR_API_KEY&match_id=12345

Match Statistics

GET /statistics

Get detailed statistics for a specific World Cup match.

📖 View Detailed Documentation →

Parameters:

key (required) - Your API key
match_id (required) - The match ID

Example Request:

GET /statistics?key=YOUR_API_KEY&match_id=12345

Lineups

GET /lineups

Get starting lineups and substitutes for a specific match.

📖 View Detailed Documentation →

Parameters:

key (required) - Your API key
match_id (required) - The match ID
lang (optional) - Language code (es, fr, de, etc.) - defaults to English

Example Request:

GET /lineups?key=YOUR_API_KEY&match_id=12345

Squads

GET /squads

Get all teams and their squads participating in World Cup 2026.

📖 View Detailed Documentation →

Parameters:

key (required) - Your API key
team_id (required) - The team ID
lang (optional) - Language code (es, fr, de, etc.) - defaults to English

Example Request:

GET /squads?key=YOUR_API_KEY&team_id=12345

Historical Matches

GET /history

Get historical match data for World Cup 2026.

📖 View Detailed Documentation →

Parameters:

key (required) - Your API key
date_from (optional) - Start date (YYYY-MM-DD)
date_to (optional) - End date (YYYY-MM-DD)
lang (optional) - Language code (es, fr, de, etc.) - defaults to English
page (optional) - Page number (default: 1)
team_id (optional) - The team ID

Example Request:

GET /history?key=YOUR_API_KEY&date_from=2026-06-01&date_to=2026-07-15

Head-to-Head

GET /head2head

Get head-to-head statistics between two teams.

📖 View Detailed Documentation →

Parameters:

key (required) - Your API key
team1_id (required) - First team ID
team2_id (required) - Second team ID
lang (optional) - Language code (es, fr, de, etc.) - defaults to English

Example Request:

GET /head2head?key=YOUR_API_KEY&team1_id=123&team2_id=456

Live Standings

GET /livestandings

Get the lives standings table as matches are being played.

📖 View Detailed Documentation →

Parameters:

key (required) - Your API key
group (required) - Filter by specific group (A, B, C, etc.)
lang (optional) - Language code (es, fr, de, etc.) - defaults to English

Example Request:

GET /livestandings?key=YOUR_API_KEY&group=A

Group Standings

GET /standings

Get the overall standings table for World Cup 2026.

📖 View Detailed Documentation →

Parameters:

key (required) - Your API key
group (required) - Filter by specific group (A, B, C, etc.)
form (optional) - The form of the team W,D,L
lang (optional) - Language code (es, fr, de, etc.) - defaults to English

Example Request:

GET /standings?key=YOUR_API_KEY&group=A

Top Goalscorers

GET /goalscorers

Get top goalscorers for World Cup 2026.

📖 View Detailed Documentation →

Parameters:

key (required) - Your API key
lang (optional) - Language code (es, fr, de, etc.) - defaults to English

Example Request:

GET /goalscorers?key=YOUR_API_KEY

Top Disciplinary

GET /cards

Get top disciplinary statistics (cards) for World Cup 2026.

📖 View Detailed Documentation →

Parameters:

key (required) - Your API key
lang (optional) - Language code (es, fr, de, etc.) - defaults to English

Example Request:

GET /cards?key=YOUR_API_KEY

Response Formats

All API endpoints return data in JSON format only. The response structure follows a consistent pattern:

{
  "success": true,
  "data": {
	// Response data here
  }
}

In case of an error, the response will include:

{
  "success": false,
  "error": "Error message",
  "code": 400
}

Download Postman Collection

Import all API endpoints into Postman for easy testing

Download Collection Download Translations Collection

Need Help?

If you have questions or need assistance, please check your dashboard or contact support.

Go to Dashboard