FIFA Rankings

List FIFA ranking periods (Paid)

Returns a paginated list of available FIFA ranking periods for a given ranking type, including each period's date, display name, source, sync status, and whether it is the current period.

Plan: Requires a paid plan (Starter, Pro, or Enterprise).

get/fifa-rankings/periods

Request

  • Base URL: https://footballdata.io/api/v1
  • URL: https://footballdata.io/api/v1/fifa-rankings/periods
  • Auth: HTTP bearer

Query parameters

ranking_typestring

Ranking gender. Allowed: 'men', 'women'.

pageinteger

Page number (min 1).

limitinteger

Results per page, clamped to 1-100.

Response

Successful response

successboolean
dataobject[]

Data payload is an array of period entries; each has period_id, ranking_date, display_name, ranking_type, source, source_period_id, sync_status, is_current (bool), and last_updated.

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.