Competitions

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

Leagues, cups and qualifiers, with the seasons available for each.

Freshness — cached for 1 hour. 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
`id`	integer	100486	Identifier of a single record.
`name`	string	Premier League	Exact name match.
`country`	string	England	Country name.
`code`	string	GB	Country or team code.
`season`	integer	2026	Season, as a four digit start year.
`team`	integer	100005	Team identifier.
`type`	string	Goal	Narrows the result to one type.
`current`	boolean	true	Only the season currently in progress.
`search`	string	manchester	Partial name search. Minimum three characters.
`last`	integer	10	The most recent N matches. Maximum 99.
`coverage`	boolean	true	Include what each season has data for. On automatically when id is given.
`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/competitions?id=100486' \
--header 'Accept: application/json' \
--header 'X-API-Key: api_mart_your_key_here'

Response

json

{
    "success": true,
    "data": [
        {
            "id": 100001,
            "name": "Premier League",
            "type": "League",
            "logo": "https://apinex.iotait.tech/images/competitions/100001.png",
            "country": {
                "name": "England",
                "code": "GB-ENG",
                "flag": "https://apinex.iotait.tech/images/flags/gb-eng.svg"
            },
            "seasons": [
                {
                    "year": 2010,
                    "start": "2010-08-14",
                    "end": "2011-05-22",
                    "is_current": false
                },
                {
                    "year": 2011,
                    "start": "2011-08-13",
                    "end": "2012-05-13",
                    "is_current": false
                },
                {
                    "year": 2012,
                    "start": "2012-08-18",
                    "end": "2013-05-19",
                    "is_current": false
                },
                {
                    "year": 2013,
                    "start": "2013-08-17",
                    "end": "2014-05-11",
                    "is_current": false
                },
                {
                    "year": 2014,
                    "start": "2014-08-16",
                    "end": "2015-05-24",
                    "is_current": false
                },
                {
                    "year": 2015,
                    "start": "2015-08-08",
                    "end": "2016-05-17",
                    "is_current": false
                },
                {
                    "year": 2016,
                    "start": "2016-08-13",
                    "end": "2017-05-21",
                    "is_current": false
                },
                {
                    "year": 2017,
                    "start": "2017-08-11",
                    "end": "2018-05-13",
                    "is_current": false
                },
                {
                    "year": 2018,
                    "start": "2018-08-10",
                    "end": "2019-05-12",
                    "is_current": false
                },
                {
                    "year": 2019,
                    "start": "2019-08-09",
                    "end": "2020-07-26",
                    "is_current": false
                },
                {
                    "year": 2020,
                    "start": "2020-09-12",
                    "end": "2021-05-23",
                    "is_current": false
                },
                {
                    "year": 2021,
                    "start": "2021-08-13",
                    "end": "2022-05-22",
                    "is_current": false
                },
                {
                    "year": 2022,
                    "start": "2022-08-05",
                    "end": "2023-05-28",
                    "is_current": false
                },
                {
                    "year": 2023,
                    "start": "2023-08-11",
                    "end": "2024-05-19",
                    "is_current": false
                },
                {
                    "year": 2024,
                    "start": "2024-08-16",
                    "end": "2025-05-25",
                    "is_current": false
                },
                {
                    "year": 2025,
                    "start": "2025-08-15",
                    "end": "2026-05-24",
                    "is_current": false
                },
                {
                    "year": 2026,
                    "start": "2026-08-21",
                    "end": "2027-05-30",
                    "is_current": true
                }
            ]
        }
    ],
    "meta": {
        "results": 1,
        "page": 1,
        "total_pages": 1
    }
}