Response Elements

Response fields

Type

Description

id

Integer

This is the Api-Football assigned ID of the team.

name

String

This field contains the name of the team.

code

String

This is the Api-Football assigned code of the team.

country

String

This shows which country the team belongs to.

founded

Integer

This field specifies the year in which the team was founded.

national

Boolean

This signifies whether the team is a national team or a domestic team. In case of false, it's a domestic team; otherwise, it's a national team.

logo

String

This field contains a link for the logo of the team.

Response fields

Type

Description

id

Integer

This is the ID of the venue.

name

String

This is the name of the venue.

address

String

This is the address of the venue.

city

String

This field represents the city in which the venue is located

capacity

Integer

This informs us about the maximum capacity of the stadium.

surface

String

This tells us what kind of pitch is being used in the venue, such as grass or turf.

image

String

This field contains a link for an image of the venue.

Response fields

Type

Description

played

Object

This object contains information about the number of matches played by the team in the specified season.

wins

Object

This object contains information about the number of matches the team won in the specified season.

draws

Object

This object contains information about the number of matches drawn by the team in the specified season.

loses

Object

This object contains information about the number of matches lost by the team in the specified season.

Response fields

Type

Description

id

Integer

This is the ID of the league.

name

String

This is the name of the league.

country

String

This represents the name of the country whose league is retrieved in the response.

logo

String

This contains a link for the logo of the league.

flag

String

This contains a link to a picture of the flag of the country to which the league is affiliated.

season

Integer

This specifies the season for which the information is retrieved.

Response fields

Type

Description

rank

Integer

This is the rank of a team in the league.

team

Object

This object contains information about the team at a specific rank.

points

Integer

This field specifies the points gained by the team.

goalsDiff

Integer

This represents the goal difference of a team.

form

String

This shows the result of the last five matches of the team.

status

String

This shows whether the team has decreased or increased its rank or stayed the same.

description

String

This shows whether the team is qualifying for a cup or being relegated.

all

Object

This object contains the number of matches won, lost, and drawn by the team.

home

Object

This object contains the number of home matches won, lost, and drawn by the team.

away

Object

This object contains the number of away matches won, lost, and drawn by the team.

update

String

This is the time in which the retrieved information was updated.

Response fields

Type

Description

id

Integer

This is the database ID of the fixture.

referee

String

This field contains the name of the referee of the fixture.

timezone

String

This is the timezone for which the time of the fixture is indicated.

date

String

This represents the date on which the fixture is scheduled.

timestamp

String

This field is the encoded time of the fixture.

periods

Object

This object contains the start time of the first and second half of the fixture in encoded form.

venue

Object

This object contains information about the stadium.

status

Object

This object contains information about the current position of the fixture and the elapsed minutes.

Response fields

Type

Description

games

Object

This object contains information about the match contribution of the player.

offsides

Integer

This is the number of times the player strayed offside.

shots

Object

This object contains information about the shots taken by the player.

goals

Object

This object contains information about the goals scored and conceded by the player.

passes

Object

This object contains the passing statistics of the player.

tackles

Object

This object contains information about the tackles made by the player.

duels

Object

This contains information about the duels the player was involved in during the match.

dribbles

Object

This object contains the dribbling stats of the player.

fouls

Object

This object contains the fouls drawn and conceded by the player.

cards

Object

This object contains the number of red or yellow cards given to the player by the officials.

penalty

Object

This object contains the penalties given and taken by the player.

Response fields

Type

Description

id

Integer

This is the Api-Football assigned ID of the player.

name

String

This field is the name of the player.

age

Integer

This is the age of the player.

birth

Object

This object contains the date, place, and country of birth of the player.

nationality

String

This tells us the nationality of the player.

height

String

This is the height of the player in cm.

weight

String

This is the weight of the player in kg.

injured

Boolean

This tells us whether the player is injured or not at the time of the API call.

photo

String

This field contains the link for a photo of the player.