Matches

List matches by date

Plan: Available on the free plan.

get/matches/date/{date}

Request

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

Path parameters

datestring required

Date to list matches for (YYYY-MM-DD). Required; endpoint returns 400 invalid_date if missing or malformed.

Query parameters

league_idinteger

Filter by league id.

season_idinteger

Filter by season id.

statusstring

Filter by match status (exact match).

sortstring

Sort direction by match_date/id. Allowed: asc, desc (anything else falls back to asc).

pageinteger

Page number (1-based).

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.