Leagues & Countries

List countries

Returns a paginated, optionally searchable list of active countries with ISO codes and flag image URLs.

Plan: Available on the free plan.

get/countries

Request

  • Base URL: https://footballdata.io/api/v1
  • URL: https://footballdata.io/api/v1/countries
  • Auth: HTTP bearer

Query parameters

searchstring

Case-insensitive substring filter applied to country name, ISO (2-letter) code, and FIFA ISO3 code.

pageinteger

Page number (min 1) for pagination.

limitinteger

Results per page; clamped to the range 1-250.

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.