# Welcome to Goalise Football API

Goalise provides reliable football data tailored for developers who need live, historical, and prediction insights for football matches across leagues worldwide.

Whether you're building a fantasy football app, sports analytics dashboard, or just need football data, Goalise has you covered.

## 🧩 What to do with Goalise?

- Retrieve **live match scores**, **events**, **odds** and **statistics**.
- Access **team and player statistics**, including form and goals.
- Fetch **league standings**, **top scorers**, and **matches** by season.
- Use advanced **prediction** endpoints for future matches.
- Filter data by **league**, **team**, **season**, or **match ID**.
- For more things you can do, see [API Reference](/apireference/openapi) section.


## 🚀 Quick Start

To start using the Goalise API:

1. **Subscribe to a pricing plan**
[Choose your plan](https://goalise.com/checkout) and billing period.
2. **Get Your API Key**
Once subscribed, your API key will be available under your [dashboard](https://goalise.com/account).
3. **Make Your First Request**


Here's an example using `curl`:


```bash
curl -X GET "https://api.goalise.com/api/v2/matches?league_id=618&season=2024" \
  -H "Authorization: Bearer YOUR_API_TOKEN"
```

## 📚 API Reference

A quick overview of available API endpoint groups:

### 🌍 Countries

List of all supported countries with flags and codes. Use the `available_leagues` property from country object to check if the country has leagues in our API.

[See more →](/apireference/openapi#tag/Countries)

### 🏆 Leagues

All competitions by country, including seasons, rounds, and detailed information.

[See more →](/apireference/openapi#tag/Leagues)

### 🏟️ Teams

Club and national teams including statistics and detailed info.

[See more →](/apireference/openapi#tag/Teams)

### 👤 Players

Players with personal data, stats, transfers, ratings and more.

[See more →](/apireference/openapi#tag/Players)

### 📅 Matches

Scheduled and live matches with status, score, lineup, events and statistics.

#### Match Status Codes

List of possible short match status codes used in the API:

| Code | Description |
|  --- | --- |
| TBD | Scheduled but date and time are not known |
| NS | Match is scheduled and has not started |
| 1H | First half is in progress |
| HT | Match is at halftime |
| 2H | Second half is in progress |
| ET | Extra time is being played |
| BT | Break during extra time |
| P | Penalty shootout is in progress |
| SUSP | Suspended by referee’s decision, may be rescheduled |
| INT | Match interrupted temporarily, should resume shortly |
| FT | Match finished in regular time |
| AET | Match finished after extra time |
| PEN | Match finished after penalties |
| PST | Postponed to a later date |
| CANC | Cancelled and will not be played |
| ABD | Abandoned before completion (e.g., weather, safety) |
| AWD | Technical loss awarded (not played) |
| WO | WalkOver — opponent forfeited |
| LIVE | In progress but detailed timing not available |


[See more →](/apireference/openapi#tag/Matches)

### 📊 Standings

League tables with rankings, points, form, etc.

[See more →](/apireference/openapi#operation/getLeagueStanding)

### ⚽ Events

In-match events like goals, cards, substitutions.

[See more →](/apireference/openapi#operation/getMatchEvents)

### 📈 Statistics

Detailed match stats per team and player.

[See match statistics →](/apireference/openapi#operation/getMatchStatistics)

[See team statistics →](/apireference/openapi#operation/getTeamStatistics)

[See player statistics →](/apireference/openapi#operation/playerStatistics)

[See player match statistics →](/apireference/openapi#operation/getPlayerMatchStatistics)

### 🔁 Transfers

Player transfer history and current market data.

[See more →](/apireference/openapi#tag/Transfers)

### 🧠 Predictions

Match outcome predictions and tips.

[See more →](/apireference/openapi#tag/Predictions)

### 🎯 Odds

Bookmaker odds and live odds for each match.

[See more →](/apireference/openapi#tag/Odds)

### 📹 Video Highlights

Match video highlights (will be available soon).

### 🏅 Top Scorers

List of top players by goals, assists, cards, etc.

[See more →](/apireference/openapi#operation/getTopScorers)

### 🗓️ Seasons

All available seasons per league.

[See more →](/apireference/openapi#operation/getLeagueSeasons)

### 🌐 Coverage

Check which data features are available for each league. Coverage are included in league objects.

[See more →](/apireference/openapi#operation/getLeagues)

### 📰 News

Latest football news, articles, and updates by date, team, league or category.

[See more →](/apireference/openapi#tag/News)

### 🏟️ Venues

Stadium information including name, location, capacity, and surface type.

[See more →](/apireference/openapi#tag/Venues)

Explore all available endpoints in the [API Reference](/apireference/openapi) section.

## 💡 Tips

- All parameters are case-sensitive.
- Use `id`, `team_id`, `league_id`, and `season` when available to filter data efficiently.
- Follow rate limits defined by your subscription to avoid being blocked.


Still have questions? Visit the [Support](https://goalise.com/support) or contact us directly.

Happy coding! ⚽️