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.

Entertainment
1 credits/call

Pricing

1 credits/call
ConditionCharge
Each call1 credits/call

Parameters

Optional parameters use the platform defaults when omitted.

ParameterTypeRequiredDescriptionDefault
idintegerNoFilter by id.—
tostringNoFilter by to.—
idsstringNoFilter by ids.—
datestringNoFilter by date.—
fromstringNoFilter by from.—
lastintegerNoReturn 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.—
livestringNoFilter by live.—
nextintegerNoFilter by next.—
teamintegerNoFilter by team.—
roundstringNoFilter by round.—
venueintegerNoFilter by venue.—
leagueintegerNoFilter by league.—
seasonintegerNoFilter by season.—
statusstringNoFilter by status.—
timezonestringNoFilter by timezone.—

Invocation example

Copy the request and explore its response example.

POST/agent-api/v1/tool/executeX-Api-Key
Request 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
JSONPartial content
{
  "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.