Match Overview Validation

These resources are used by Match resources to cross-reference static data related to high-level match information. (Personnel resources also cross-reference Country resource representations.)

Confederations

GET /v0/confederations/(int: ID)

Returns the names of the football confederations in the world. If ID is passed, return data for the confederation the ID corresponds to.

If query parameters are passed, it returns the record that matches the specified filters.

Query and Response Parameters:

Field Type Description
name string Acronym of football confederation.

Link Parameters:

Field URL Description
countries Countries resource representation.
OPTIONS /v0/confederations

Returns documentation of the confederations resource.

Countries

GET /v0/countries/(int: ID)

Returns the names of the “FIFA countries” – the FIFA-affiliated football associations in the world. If ID is passed, return data for the country the ID corresponds to.

If query parameters are passed, it returns the records that match the specified filters.

Query and Response Parameters:

Field Type Description
name string Popular name of FIFA-affiliated football association.
confederation integer The unique ID of the football confederation the country belongs to.

Link Parameters:

Field URL Description
confederation Confederations resource representation.
managers Managers resource representations of same country.
players Players resource representation of same country.
referees Referees resource representation of same country.
venues Match Venues resource representation of same country.
teams Teams resource representation of same country.
OPTIONS /v0/countries

Returns documentation of the countries resource.

Competitions

GET /v0/competitions/(int: ID)

Returns the names of the football competitions in the database. If ID is passed, return the competition record the ID corresponds to.

If query parameters are passed, it returns the records that match the specified filters.

Query and Response Parameters:

Field Type Description
name string The name of the football competition.
supplier_id integer The unique supplier ID of the competition record.
OPTIONS /v0/competitions

Returns documentation of the competitions resource.

Weather

GET /v0/weather/(int: ID)

Returns the descriptions of specific weather conditions. The descriptions are terms used by the US National Weather Service.

If ID is passed, return the weather condition record the ID corresponds to.

If query parameters are passed, it returns the records that match the specified filters.

Query and Response Parameters:

Field Type Description
desc string Description of the weather condition, using terms from US NOAA National Weather Service.
OPTIONS /v0/weather

Returns documentation of the weather condition resource.

Playing Surfaces

GET /v0/surfaces/(int: ID)

Returns the descriptions of playing surfaces. If ID is passed, return the surface record the ID corresponds to.

If query parameters are passed, it returns the records that match the specified filters.

Query and Response Parameters:

Field Type Description
name string The type of field surface.
OPTIONS /v0/surfaces

Returns documentation of the playing surface resource.

Seasons

GET /v0/seasons/(int: ID)

Returns the competition season year(s). If ID is passed, return the season year(s) the ID corresponds to.

If query parameters are passed, it returns the records that match the specified filters.

Query and Response Parameters:

Field Type Description
name string Season year(s).
supplier_id integer The unique supplier ID of the season record.
OPTIONS /v0/seasons

Returns documentation of the seasons resource.

Teams

GET /v0/teams/(int: ID)

Returns the name of the club team. If ID is passed, return the team the ID corresponds to.

If query parameters are passed, it returns the records that match the specified filters.

Query and Response Parameters:

Field Type Description
name string The club team name.
country integer The unique ID of the country where the club team resides.
supplier_id integer The unique supplier ID of the team record.

Link Parameters:

Field URL Description
country Countries resource representation.
OPTIONS /v0/teams

Returns documentation of the team resource.

Match Venues

GET /v0/venues/(int: ID)

Returns data on the match venue where a football match is held. If ID is passed, return the match venue the ID corresponds to.

If query parameters are passed, it returns the records that match the specified filters.

Query and Response Parameters:

Field Type Description
name string The name of the match venue.
team integer The unique ID of the team who plays its home matches at the venue. If there are multiple home teams, this field is set to null.
city string The name of the city where the venue resides.
country integer The unique ID of the country where the venue resides.
latitude float The latitude of the venue in decimal degrees.
longitude float The longitude of the venue in decimal degrees.
altitude float The altitude of the venue in meters.
length integer The length of the venue playing surface in meters.
width integer The width of the venue playing surface in meters.
capacity integer The total capacity of the venue.
seated integer The total number of seats at the venue.
surface integer The unique ID of the playing surface type that the venue uses for matches.

Link Parameters:

Field URL Description
country Countries resource representation.
OPTIONS /v0/venues

Returns documentation of the match venue resource.