Soccer's API v2.2 Documentation

Status	Name	Description
0	Not Started	The event is not started
1	Inplay	The event is inplay
11	Half-time	The event is in half-time.
12	Extra-time	The event is in extra time.
13	Penalties	The event is in penalties because extra time didn't determinate a winner.
14	Break-time	Event is in break waiting for extra time or penalties.
15	Awarding	Awarding of a victory to a contestant because there are no other contestants.
2	Update later	Event will be updated later.
3	Ended	Event has ended after 90 minutes.
31	After penalties	Event has ended after penalty shootout.
32	After Extra-time	The event has finished after extra time.
4	Postponed	The event has been Postponed.
5	Cancelled	The event has been Cancelled.
6	Abandoned	The event has abandoned and will continue at a later time or day.
7	interrupted	The event has been interrupted. Can be due to bad weather for example.
8	Suspended	The event has been suspended.
9	Awarded	Winner is beeing decided externally.
10	Delayed	The event is delayed.
17	To be announced	The event has not been verified yet.

Leagues

Teams

Players

TV Channels

Coaches

Referees

Bookmakers

Venues

## [2.2]
Added
- New Bookmaker "Betika" #match_odds

## [2.2]
Added
- Bookmakers custom sort #match_odds

## [2.2]
Added
- New Language "Chinese simplified" (ZH_CN) #lang

## [2.2]
Added
- New Language "Chinese" (ZH) #lang

## [2.2]
Added
- New Language "Portuguese" (PT) #lang

## [2.2]
Added
- New Language "Turkish" (TR) #lang

## [2.2]
Added
- New Language "Polish" (PL) #lang

## [2.2]
Added
- New Language "French" (FR) #lang

## [2.2]
Added
- New endpoint "Standings Live" #standings_live

## [2.2]
Added
- Added the capability to search Matches #search_all

## [2.2]
Added
- Added the capability to search TV Channels #search_all

## [2.2]
Improved
- On "TV Channels by Match" coverage improved #match_tv

## [2.2]
Added
- New Endpoint "TV Channels by Country" #tv_channels_country

---

## [2.2]
Added
- New Endpoint "All TV Channels" #tv_channels_all

---

## [2.2]
Added
- New Endpoint "Coaches by Country" #coaches_country

---

## [2.2]
Added
- New Endpoint "All Coaches" #coaches_all

---

## [2.2]
Added
- New Endpoint "Venues by Country" #venues_country

---

## [2.2]
Added
- New Endpoint "All Venues" #venues_all

---

## [2.2]
Added
- 'team_id' on player's information to know quickest current national team ID.
- 'national_team_id' on player's information to know quickest current national team ID.

#player_id

---

## [2.2]
Added
- 'position_name' on lineups from today's matches (left winger, right winger...)

---

## [2.2]
Added
- Attendance

---

## [2.2]
Added
- Fixtures by TV Channel (2 weeks forecast) #fixtures_tv_channel

---

## [2.2]
Added
- Improvement on standings request #Standings. Were added a field called "number_standings". If is more than 1, is an array with special leagues that have more than 1 standings information and each are tagged in group_name. It happen for example in Indian I-League.

---

## [2.2]
Added
- Added new dataset "info" in all fixtures from today. If there're information about match for example 'Decision by Federation' you'll find in there.

---

## [2.2]
Added
- Added new dataset include "Match Events" in #Livescores, #Fixtures, #MatchById, #MatchByMultipleID. #Includes

---

## [2.2]
Added
- Added new dataset include "Match Stats" in #Livescores, #Fixtures, #MatchById, #MatchByMultipleID. #Includes

---

## [2.2]
Added
- Added includes feature in #MatchByMultipleID endpoint #Includes

---

## [2.2]
Added
- Added includes feature in #MatchByID endpoint #Includes

---

## [2.2]
Added
- Added includes feature in #livescores endpoints #Includes

---

## [2.2]
Added
- Filter by status_id on #Fixtures_by_season

---

## [2.2]
Added
- Added includes feature in fixtures endpoints #Includes

---

## [2.2]
Added
- Added endpoint Leagues by Multiple ID #leagues_multiple_id

---

## [2.2]
Changed
- Match lineups will show formations without stats of every player in order to avoid delays in this endpoint. If you need to know stats of every player you can add this code in request &include=stats #match_lineups

---

## [2.2]
Beta
- Added API Translations to Arabic, Greek and Italian. #language

---

## [2.2]
Added
- Added market_value parameter in player's info.

---

## [2.2]
Added
- Added endpoint for check all groups by season id.

---

## [2.2]
Added
- Added teams and league images in all H2H endpoints.

---

## [2.2]
Added
- UTC parameter enabled in Fixtures and Livescores endpoint, by adding &utc=4 or &utc=4.5 at the end of your request to get rensponse in your correct timezone.

---

## [2.2]
Added
- Timestamp parameter in match events from today

---

## [2.2]
Fixed
- Endpoint Season Stats > goal_line has been recalculated.

---

## [2.2]
Added
- New Endpoint Player Stats by Match ID #player_stats_match

---

## [2.2]
Added
- New Endpoint Cup Draw (Tournament Bracket) #cup_draw

---

## [2.2]
Added
- New Endpoint TV Channel by ID #tv_info

---

## [2.2]
Added
- TV Channels images in 4 differents sizes (100,80,50,18)

---

## [2.2]
###Update
- Venue images in png and added our current image px formats (100,80,50,18)

---

## [2.2]
Added
- New Endpoint added Fixtures Next & Last

---

## [2.2]
Added
In Player by ID Endpoint:
- Seasons of the leagues where specific player have participated.
- Roles and on which teams have played.

---

## [2.2]
Added
In Team by ID Endpoint:
- Seasons of the leagues where specific team have participated.
- Added more fields in array leagues on Teams by ID Endpoint.

---

## [2.2]
Added
- Basic Stats of players in Match Lineups endpoint

---

## [2.2]
Added
- Aggregate_id in fixtures endpoints and Match by ID endpoint
- Country_code in fixtures endpoints and Match by ID endpoint

---

## [2.2]
Added
- Historical data up to 10 years

---

## [2.2]
Fixed
- Fixtures endpoints datetime value to UTC

---

## [2.2]
Added
- Endpoint Match Sidelined

---

## [2.2]
Added
- Endpoint Match by Multiple IDs

---

## [2.2]
Added
- Team Kit colors on Fixtures Endpoints

---

## [2.2]
Added
- Endpoint Teams National

---

## [2.2]
Added
- Endpoint Search by Keyword

---

## [2.2]
Added
- Endpoint Stages by Season

---

## [2.2]
Added
- Endpoint Stage by ID

---

## [2.2]
Added
- Endpoint Group by ID

---

## [2.2]
Added
- Team Kit Colors (Team by ID Endpoint)

---

## [2.2]
Added
- Coverage info (Fixtures, Match by ID Endpoints)

---

## [2.2]
Added
- Endpoint TV Schedule by Date (on Broadcast & TV section)

---

## [2.2]
Added
- Endpoint H2H Team vs Team

---

## [2.2]
Added
- Endpoint All Continents
- Endpoint Continent by ID
- Order ASC / DESC in Fixtures by Season Endpoint

---

## [2.2]
Added
- Logos +800 leagues

---

## [2.2]
Added
- Endpoint Team Transfers
- Endpoint Match H2H

---

## [2.2]
Added
- Endpoint Match Odds by Bookmaker

---

## [2.2]
Added
- Team Kit colors
- Endpoint Team Trophies

Parameter	Value	Language
lang	AR	Arabic
lang	EL	Hellenic
lang	IT	Italian
lang	DE	German
lang	ES	Spanish
lang	RU	Russian
lang	KA	Georgian
lang	NL	Dutch
lang	FR	French
lang	PL	Polish
lang	PT	Portuguese
lang	TR	Turkish

Endpoint	Includes	Description
#Fixtures	&include=events,odds_prematch,odds_inplay,stats,tvs	Match events summary, Pre-match odds, In-play odds, Match Stats, Match TV Broadcast
#Livescores	&include=events,odds_prematch,odds_inplay,stats,tvs	Match events summary, Pre-match odds, In-play odds, Match Stats, Match TV Broadcast
#MatchByID	&include=events,odds_prematch,odds_inplay,stats,tvs	Match events summary, Pre-match odds, In-play odds, Match Stats, Match TV Broadcast
#MatchByMultipleID	&include=events,odds_prematch,odds_inplay,stats,tvs	Match events summary, Pre-match odds, In-play odds, Match Stats, Match TV Broadcast
#MatchLineups	&include=stats	Match player stats
#matches_tv	&include=tvs	Include TV Channels