Predictions

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

Model output for a fixture, with the form it was derived from.

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

NameTypeExampleDescription
fixturerequiredinteger100088Fixture identifier.

Example request

Paste this straight into Postman with Import → Raw text.

curl
curl --location --request GET 'https://devapi.admin.iotait.tech/api/v1/football/predictions?fixture=100088' \
--header 'Accept: application/json' \
--header 'X-API-Key: api_mart_your_key_here'

Response

json
{
    "success": true,
    "data": [
        {
            "competition": {
                "id": 100001,
                "name": "Premier League",
                "season": 2024,
                "country": "England",
                "logo": "https://apinex.iotait.tech/images/competitions/100001.png",
                "flag": "https://apinex.iotait.tech/images/flags/gb-eng.svg"
            },
            "teams": {
                "home": {
                    "id": 100005,
                    "name": "Manchester United",
                    "logo": "https://apinex.iotait.tech/images/teams/100005.png"
                },
                "away": {
                    "id": 100002,
                    "name": "Fulham",
                    "logo": "https://apinex.iotait.tech/images/teams/100002.png"
                }
            },
            "prediction": {
                "winner": {
                    "id": 100005,
                    "name": "Manchester United",
                    "logo": "https://apinex.iotait.tech/images/teams/100005.png"
                },
                "winner_comment": "Win or draw",
                "win_or_draw": true,
                "under_over": null,
                "goals": {
                    "home": null,
                    "away": null
                },
                "advice": "Double chance : Manchester United or draw",
                "percent": {
                    "home": "50%",
                    "draw": "50%",
                    "away": "0%"
                }
            },
            "comparison": {
                "form": {
                    "home": "0%",
                    "away": "0%"
                },
                "att": {
                    "home": "0%",
                    "away": "0%"
                },
                "def": {
                    "home": "0%",
                    "away": "0%"
                },
                "poisson_distribution": {
                    "home": "0%",
                    "away": "0%"
                },
                "h2h": {
                    "home": "80%",
                    "away": "20%"
                },
                "goals": {
                    "home": "64%",
                    "away": "36%"
                },
                "total": {
                    "home": "72.0%",
                    "away": "28.0%"
                }
            },
            "head_to_head": [
                {
                    "id": 100081,
                    "starts_at": "2024-02-24T15:00:00+00:00",
                    "timestamp": 1708786800,
                    "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": 2023,
                        "stage": "Regular Season - 26",
                        "country": "England",
                        "logo": "https://apinex.iotait.tech/images/competitions/100001.png",
                        "flag": "https://apinex.iotait.tech/images/flags/gb-eng.svg"
                    },
                    "home": {
                        "id": 100005,
                        "name": "Manchester United",
                        "logo": "https://apinex.iotait.tech/images/teams/100005.png",
                        "score": 1,
                        "score_at_half": 0,
                        "outcome": "lost"
                    },
                    "away": {
                        "id": 100002,
                        "name": "Fulham",
                        "logo": "https://apinex.iotait.tech/images/teams/100002.png",
                        "score": 2,
                        "score_at_half": 0,
                        "outcome": "won"
                    },
                    "extra_time": null,
                    "penalties": null,
                    "venue": {
                        "id": 100046,
                        "name": "Old Trafford",
                        "city": "Manchester"
                    },
                    "referee": "M. Oliver"
                },
                {
                    "id": 100082,
                    "starts_at": "2023-11-04T12:30:00+00:00",
                    "timestamp": 1699101000,
                    "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": 2023,
                        "stage": "Regular Season - 11",
                        "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": 0,
                        "score_at_half": 0,
                        "outcome": "lost"
                    },
                    "away": {
                        "id": 100005,
                        "name": "Manchester United",
                        "logo": "https://apinex.iotait.tech/images/teams/100005.png",
                        "score": 1,
                        "score_at_half": 0,
                        "outcome": "won"
                    },
                    "extra_time": null,
                    "penalties": null,
                    "venue": {
                        "id": 100004,
                        "name": "Craven Cottage",
                        "city": "London"
                    },
                    "referee": "J. Brooks"
                },
                {
                    "id": 100083,
                    "starts_at": "2023-05-28T15:30:00+00:00",
                    "timestamp": 1685287800,
                    "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": 2022,
                        "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": 100005,
                        "name": "Manchester United",
                        "logo": "https://apinex.iotait.tech/images/teams/100005.png",
                        "score": 2,
                        "score_at_half": 1,
                        "outcome": "won"
                    },
                    "away": {
                        "id": 100002,
                        "name": "Fulham",
                        "logo": "https://apinex.iotait.tech/images/teams/100002.png",
                        "score": 1,
                        "score_at_half": 1,
                        "outcome": "lost"
                    },
                    "extra_time": null,
                    "penalties": null,
                    "venue": {
                        "id": 100046,
                        "name": "Old Trafford",
                        "city": "Manchester"
                    },
                    "referee": "R. Jones"
                },
                {
                    "id": 100084,
                    "starts_at": "2023-03-19T16:30:00+00:00",
                    "timestamp": 1679243400,
                    "timezone": "UTC",
                    "state": {
                        "code": "finished",
                        "label": "Finished",
                        "minute": 90,
                        "is_live": false,
                        "is_finished": true,
                        "is_scheduled": false
                    },
                    "competition": {
                        "id": 100085,
                        "name": "FA Cup",
                        "season": 2022,
                        "stage": "Quarter-finals",
                        "country": "England",
                        "logo": "https://apinex.iotait.tech/images/competitions/100085.png",
                        "flag": "https://apinex.iotait.tech/images/flags/gb-eng.svg"
                    },
                    "home": {
                        "id": 100005,
                        "name": "Manchester United",
                        "logo": "https://apinex.iotait.tech/images/teams/100005.png",
                        "score": 3,
                        "score_at_half": 0,
                        "outcome": "won"
                    },
                    "away": {
                        "id": 100002,
                        "name": "Fulham",
                        "logo": "https://apinex.iotait.tech/images/teams/100002.png",
                        "score": 1,
                        "score_at_half": 0,
                        "outcome": "lost"
                    },
                    "extra_time": null,
                    "penalties": null,
                    "venue": {
                        "id": 100046,
                        "name": "Old Trafford",
                        "city": "Manchester"
                    },
                    "referee": "C. Kavanagh"
                },
                {
                    "id": 100086,
                    "starts_at": "2022-11-13T16:30:00+00:00",
                    "timestamp": 1668357000,
                    "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": 2022,
                        "stage": "Regular Season - 16",
                        "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": 1,
                        "score_at_half": 0,
                        "outcome": "lost"
                    },
                    "away": {
                        "id": 100005,
                        "name": "Manchester United",
                        "logo": "https://apinex.iotait.tech/images/teams/100005.png",
                        "score": 2,
                        "score_at_half": 1,
                        "outcome": "won"
                    },
                    "extra_time": null,
                    "penalties": null,
                    "venue": {
                        "id": 100004,
                        "name": "Craven Cottage",
                        "city": "London"
                    },
                    "referee": "P. Tierney"
                }
            ]
        }
    ],
    "meta": {
        "results": 1,
        "page": 1,
        "total_pages": 1
    }
}