API Sports Football Get Fixtures
1 credits/call
ae_api_sports_football_get_fixtures
Search for football matches by date, league, team, or live status using API-Sports.
1 credits/call
Pricing
1 credits/call
| Condition | Charge |
|---|---|
| Each call | 1 credits/call |
Parameters
Optional parameters use the platform defaults when omitted.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
id | integer | No | Filter by id. | — |
to | string | No | Filter by to. | — |
ids | string | No | Filter by ids. | — |
date | string | No | Filter by date. | — |
from | string | No | Filter by from. | — |
last | integer | No | Return the last N results. API-Sports Football free plans do not have access to this parameter; use id, date, from/to, league+season+round, or omit last on free keys. | — |
live | string | No | Filter by live. | — |
next | integer | No | Filter by next. | — |
team | integer | No | Filter by team. | — |
round | string | No | Filter by round. | — |
venue | integer | No | Filter by venue. | — |
league | integer | No | Filter by league. | — |
season | integer | No | Filter by season. | — |
status | string | No | Filter by status. | — |
timezone | string | No | Filter by timezone. | — |
Invocation example
Copy the request and explore its response example.
POST
/agent-api/v1/tool/executeX-Api-KeyRequest coderequest.sh
curl --request POST \
--url 'https://agentearth.ai/agent-api/v1/tool/execute?tool_name=ae_api_sports_football_get_fixtures' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"id": 1492977
}
}'Response exampleresponse.json
{
"errors": [],
"get": "fixtures",
"paging": {
"current": 1,
"total": 1
},
"parameters": {
"id": "1492977"
},
"response": [
{
"events": [
{
"assist": {
"id": null,
"name": null
},
"comments": null,
"detail": "Normal Goal",
"player": {
"id": 82447,
"name": "R. Keating"
},
"team": {
"id": 653,
"logo": "https://media.api-sports.io/football/teams/653.png",
"name": "Cork City"
},
"type": "Goal"
}
],
"fixture": {
"date": "2026-09-18T18:45:00+00:00",
"id": 1492977,
"periods": {
"first": 1789757100,
"second": 1789760700
},
"referee": null,
"status": {
"elapsed": 90,
"extra": 2,
"long": "Match Finished",
"short": "FT"
},
"timestamp": 1789757100
},
"goals": {
"away": 1,
"home": 5
},
"league": {
"country": "Ireland",
"flag": "https://media.api-sports.io/flags/ie.svg",
"id": 358,
"logo": "https://media.api-sports.io/football/leagues/358.png",
"name": "First Division",
"round": "Regular Season - 32"
},
"lineups": [],
"players": []
}
],
"results": 1
}This example shows part of the response. Copied content is valid JSON.

