Head To Head

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

Previous meetings between two teams.

Freshness — cached for 15 minutes. 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
`teams`required	string	100005,100003	Exactly two team 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.
`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.
`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.

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/head-to-head?teams=100005%2C100003' \
--header 'Accept: application/json' \
--header 'X-API-Key: api_mart_your_key_here'

Response

json

{
    "success": true,
    "data": [
        {
            "id": 100027,
            "starts_at": "2026-03-04T20:15:00+00:00",
            "timestamp": 1772655300,
            "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 - 29",
                "country": "England",
                "logo": "https://apinex.iotait.tech/images/competitions/100001.png",
                "flag": "https://apinex.iotait.tech/images/flags/gb-eng.svg"
            },
            "home": {
                "id": 100003,
                "name": "Newcastle",
                "logo": "https://apinex.iotait.tech/images/teams/100003.png",
                "score": 2,
                "score_at_half": 1,
                "outcome": "won"
            },
            "away": {
                "id": 100005,
                "name": "Manchester United",
                "logo": "https://apinex.iotait.tech/images/teams/100005.png",
                "score": 1,
                "score_at_half": 1,
                "outcome": "lost"
            },
            "extra_time": null,
            "penalties": null,
            "venue": {
                "id": 100028,
                "name": "St. James' Park",
                "city": "Newcastle"
            },
            "referee": "P. Bankes"
        }
    ],
    "meta": {
        "results": 1,
        "page": 1,
        "total_pages": 1
    }
}