Match Resources

The Match Resources are a collection of macro-events, micro-events, and summary statistics resources in the Connect API.

So that everyone understands what we mean when we use these terms, the table below describes our definitions with a few examples.

Resource Type Description Examples
Macro Events Top-level historical events associated with a football match, typically seen in a match report. Lineups, goals, bookings, substitutions
Micro Events Events internal to a football match that produce the top-level historical events, parameterized by player, match time, and field location. passes, shots, fouls, tackles, off-ball player positioning
Summary Statistics Tabulations of events in a football match, derived from micro events. shots on/off goal, crosses, final third actions

We group match resources by their association with club or national team games. Our match resource endpoints have the following structure:

GET /v1/(match_type)/(resource)
Parameters:
  • match_type – Match type.
  • resource – Resource category.

Where match_type and resource take on the following values:

match_type Description
clubs Club matches.
national National team matches.
resource Description
matches Macro-scale match resources.
events Micro-scale match resources.
stats Match statistics resources.