Countries

GEThttps://devapi.admin.iotait.tech/api/v1/football/countries

Countries with football coverage.

Freshness — cached for 1 day. Repeating the same query inside that window is answered from cache in single digit milliseconds, and meta.cache reads HIT.

Query parameters

Name	Type	Example	Description
`name`	string	Premier League	Exact name match.
`code`	string	GB	Country or team code.
`search`	string	manchester	Partial name search. Minimum three characters.
`page`	integer	1	Page number of the result set.
`per_page`	integer	50	Results per page. Defaults to 50, maximum 200.

Example request

Paste this straight into Postman with Import → Raw text.

curl

curl --location --request GET 'https://devapi.admin.iotait.tech/api/v1/football/countries?name=Premier%20League' \
--header 'Accept: application/json' \
--header 'X-API-Key: api_mart_your_key_here'

Response

json

{
    "success": true,
    "data": [
        {
            "name": "England",
            "code": "GB-ENG",
            "flag": "https://apinex.iotait.tech/images/flags/gb-eng.svg"
        }
    ],
    "meta": {
        "results": 1,
        "page": 1,
        "total_pages": 1
    }
}