FootyQuanta
Loading account…

API reference

8 groups · 43 endpoints. Base URL https://api.footyquanta.com/v1/football

Matches & live scores/Today's matchesAll plans

Today's matches

Today's fixtures and scores, using the requested UTC offset.

GET/v1/football/matches/today

Authentication: X-API-Key header. Read-only request; no request body.

Not paginated. Returns at most 2000 matches, ordered by kickoff time and ID.

Request parameters

Replace path placeholders with path parameters. Add query parameters to the URL. A dash means no default is set.

Today's matches request parameters
Parameter / LocationType / RequiredDefault / ExampleDescription
timezonequerystringOptionalDefault: UTC+00:00Example: UTC+00:00Optional fixed offset. Defaults to UTC. Accepts UTC-14:00 through UTC+14:00, not IANA timezone names. Encode + as %2B in URLs.
competition_idquerystringOptionalDefault: —Example: premier-leagueCompetition ID.

Request example

Set the FQ_API_KEY environment variable first. IDs are illustrative; replace them with real IDs returned by list endpoints.

cURL
curl 'https://api.footyquanta.com/v1/football/matches/today' \
  -H "X-API-Key: $FQ_API_KEY"

Try it

Send a real GET request using your account. Normal plan permissions, rate limits and monthly quota apply.

Request parameters

Set FQ_API_KEY to your own key when running this command locally. Empty optional values are omitted.

cURL · current parameters
curl 'https://api.footyquanta.com/v1/football/matches/today' \
  -H "X-API-Key: $FQ_API_KEY"

Response data

data is an array. Fields below describe each array element. [] denotes array elements. Missing data may be null or an empty array; neither means zero.

Today's matches response fields
FieldTypeDescription
idstringMatch ID.
kickoff_atstring/nullKickoff time in ISO 8601 format.
statusstringOne of not_started, live, finished, postponed, interrupted, abandoned, cancelled, pending or unknown.
status_localizedstringEnglish status description.
competitionobject/nullCompetition { id, name, logo, slug }.
home_teamobject/nullHome team { id, name, logo, slug }.
away_teamobject/nullAway team { id, name, logo, slug }.
venueobject/nullVenue { id, name, capacity }.
scoreobjectScore breakdown: fulltime, halftime, cards, corners, extratime and penalty.
roundinteger/nullRound number.
seasonobject/nullSeason summary { id, year }.
stageobject/nullStage summary { id, name }.
status_detailstringEnglish match phase, such as First half, HT, Second half, FT or AET.
score.fulltimeobjectCurrent/full-time score. home and away are numbers or null.
score.halftimeobjectHalf-time score. home and away are numbers or null.
score.extratimeobjectExtra-time score. home and away are numbers or null.
score.penaltyobjectPenalty shootout score. home and away are numbers or null.
score.cornersobjectCorner counts. home and away are numbers or null.
score.cardsobjecthome_red, home_yellow, away_red and away_yellow are each team's card counts. Missing counts are null.
Response envelope

code: 0 on success; message: ok on success; request_id: request tracing ID; data: endpoint data.

This endpoint does not return pagination meta. An array response does not necessarily support pagination.

Response example

Captured from a local HTTP response; nested arrays may be shortened. Values are examples, not current match results.

JSON · 200 OK
{
  "code": 0,
  "message": "ok",
  "request_id": "example-request-id",
  "data": [
    {
      "id": "1107225427623859508",
      "kickoff_at": "2026-11-02T16:00:00+00:00",
      "status": "finished",
      "status_localized": "FT",
      "status_detail": "FT",
      "competition": {
        "id": "2218430376674123805",
        "name": "AFC Champions League Elite",
        "logo": "https://img.footyquanta.com/competitions/2218430376674123805.png",
        "slug": "afc-champions-league-elite"
      },
      "season": null,
      "stage": {
        "id": "235519",
        "name": null
      },
      "home_team": {
        "id": "1583093711795574066",
        "name": "Tractor S.C.",
        "logo": "https://img.footyquanta.com/teams/1583093711795574066.png",
        "slug": "tractor-s-c-"
      },
      "away_team": {
        "id": "8447271304194135037",
        "name": "Neftchi Fargona",
        "logo": "https://img.footyquanta.com/teams/8447271304194135037.png",
        "slug": "neftchi-fargona"
      },
      "venue": {
        "id": 9157,
        "name": "Sultan Qaboos Sports Complex",
        "capacity": 28000
      },
      "round": 4,
      "score": {
        "fulltime": {
          "home": 2,
          "away": 2
        },
        "halftime": {
          "home": 0,
          "away": 0
        },
        "cards": {
          "home_red": 1,
          "home_yellow": 0,
          "away_red": 0,
          "away_yellow": 1
        },
        "corners": {
          "home": 3,
          "away": 7
        },
        "extratime": {
          "home": 0,
          "away": 0
        },
        "penalty": {
          "home": 0,
          "away": 0
        }
      }
    },
    {
      "id": "1943014566047990386",
      "kickoff_at": "2026-11-02T16:00:00+00:00",
      "status": "finished",
      "status_localized": "FT",
      "status_detail": "FT",
      "competition": {
        "id": "2218430376674123805",
        "name": "AFC Champions League Elite",
        "logo": "https://img.footyquanta.com/competitions/2218430376674123805.png",
        "slug": "afc-champions-league-elite"
      },
      "season": null,
      "stage": {
        "id": "235519",
        "name": null
      },
      "home_team": {
        "id": "7649573374367763061",
        "name": "Al-Sadd",
        "logo": "https://img.footyquanta.com/teams/7649573374367763061.png",
        "slug": "al-sadd"
      },
      "away_team": {
        "id": "2540505377931180967",
        "name": "Al-Ahli SFC",
        "logo": "https://img.footyquanta.com/teams/2540505377931180967.png",
        "slug": "al-ahli-sfc"
      },
      "venue": {
        "id": 1679,
        "name": "Jassim Bin Hamad Stadium",
        "capacity": 15000
      },
      "round": 4,
      "score": {
        "fulltime": {
          "home": 0,
          "away": 0
        },
        "halftime": {
          "home": 0,
          "away": 0
        },
        "cards": {
          "home_red": 0,
          "home_yellow": 1,
          "away_red": 0,
          "away_yellow": 3
        },
        "corners": {
          "home": 2,
          "away": 5
        },
        "extratime": {
          "home": 0,
          "away": 0
        },
        "penalty": {
          "home": 0,
          "away": 0
        }
      }
    }
  ]
}