Fixtures

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

Matches by date, league, team or live status.

Freshness — cached for 1 minute. 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	100087	Identifier of a single record.
`ids`	string	100088,100089	Several fixture ids, comma separated. Maximum 20.
`live`	string	all	"all" for every match in play, or competition ids, comma separated.
`date`	string	2026-08-30	A single day, as YYYY-MM-DD.
`competition`	integer	100090	Competition identifier, from the competitions endpoint.
`season`	integer	2026	Season, as a four digit start year.
`team`	integer	100005	Team identifier.
`last`	integer	10	The most recent N matches. Maximum 99.
`next`	integer	10	The next N matches. Maximum 99.
`from`	string	2026-08-01	Start of a date range, as YYYY-MM-DD.
`to`	string	2026-08-31	End of a date range, as YYYY-MM-DD.
`round`	string	Regular Season - 1	Competition round.
`status`	string	finished	Filter by state: scheduled, in_play, finished, or a specific one such as half_time or postponed.
`venue`	integer	100046	Venue identifier.
`timezone`	string	Asia/Dhaka	IANA timezone for kickoff times. Defaults to UTC.
`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/fixtures?id=100087' \
--header 'Accept: application/json' \
--header 'X-API-Key: api_mart_your_key_here'

Response

json

{
    "success": true,
    "data": [
        {
            "id": 100000,
            "starts_at": "2026-05-24T15:00:00+00:00",
            "timestamp": 1779634800,
            "timezone": "UTC",
            "state": {
                "code": "finished",
                "label": "Finished",
                "minute": 90,
                "is_live": false,
                "is_finished": true,
                "is_scheduled": false
            },
            "competition": {
                "id": 100001,
                "name": "Premier League",
                "season": 2025,
                "stage": "Regular Season - 38",
                "country": "England",
                "logo": "https://apinex.iotait.tech/images/competitions/100001.png",
                "flag": "https://apinex.iotait.tech/images/flags/gb-eng.svg"
            },
            "home": {
                "id": 100002,
                "name": "Fulham",
                "logo": "https://apinex.iotait.tech/images/teams/100002.png",
                "score": 2,
                "score_at_half": 1,
                "outcome": "won"
            },
            "away": {
                "id": 100003,
                "name": "Newcastle",
                "logo": "https://apinex.iotait.tech/images/teams/100003.png",
                "score": 0,
                "score_at_half": 0,
                "outcome": "lost"
            },
            "extra_time": null,
            "penalties": null,
            "venue": {
                "id": 100004,
                "name": "Craven Cottage",
                "city": "London"
            },
            "referee": "R. Jones"
        }
    ],
    "meta": {
        "results": 1,
        "page": 1,
        "total_pages": 1
    }
}