Teams

List a team's matches

Returns paginated matches for a single team (home or away), with scores, xG, odds, and probabilities, plus the team header. Each match includes a team_side field indicating whether the team played home or away.

Plan: Available on the free plan.

get/teams/{team_id}/matches

Request

  • Base URL: https://footballdata.io/api/v1
  • URL: https://footballdata.io/api/v1/teams/{team_id}/matches
  • Auth: HTTP bearer

Path parameters

team_idinteger required

Team ID to fetch matches for. Errors with missing_team_id if absent/invalid.

Query parameters

league_idinteger

Filter matches to a specific league. Triggers a per-league access check (api_require_league_access).

season_idinteger

Filter matches to a specific season.

statusstring

Filter by exact match status string (e.g. complete, incomplete, suspended).

datestring

Filter to matches on a single date (YYYY-MM-DD).

fromstring

Start of date range, inclusive (YYYY-MM-DD), matched against match_date.

tostring

End of date range, inclusive (YYYY-MM-DD), matched against match_date.

venuestring

Restrict to matches where the team was 'home' or 'away'. Any other value is ignored.

pageinteger

Page number (min 1).

limitinteger

Results per page, clamped between 1 and 100.

Response

Successful response

successboolean
metaMeta

Request metadata: usage counters, plan access, and pagination when applicable.

Example response

{
  "success": true
}

Changes

No recorded changes to this operation across all 1 revision of this API.