FIFA Rankings

List FIFA rankings (Paid)

Returns a paginated list of FIFA rankings for a given ranking type and period/date, with per-country world rank, movement, points, and confederation. Defaults to the current period when no date or period_id is supplied.

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

get/fifa-rankings

Request

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

Query parameters

ranking_typestring

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

datestring

Filter to a specific ranking date, format YYYY-MM-DD. If omitted (and no period_id), the current period is used.

period_idstring

Filter to a specific FIFA ranking period id. Auto-resolved to the current period if neither date nor period_id is given.

confederationstring

Filter by confederation code or name (e.g. UEFA, CONMEBOL).

searchstring

Search by country name, slug, or ISO2/ISO3 code.

pageinteger

Page number (min 1).

limitinteger

Results per page, clamped to 1-100.

Response

Successful response

successboolean
dataobject[]

Data payload is an array of ranking entries; each has country (name, slug, iso2, iso3, flag), ranking (type, world_rank, previous_rank, rank_movement, regional_rank, rated_matches), points (total, previous, change), confederation (code, name), period (period_id, source_period_id, ranking_date), 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.