Today's matches
Today's fixtures and scores, using the requested UTC offset.
/v1/football/matches/todayAuthentication: 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.
| Parameter / Location | Type / Required | Default / Example | Description |
|---|---|---|---|
timezonequery | stringOptional | Default: UTC+00:00Example: UTC+00:00 | Optional fixed offset. Defaults to UTC. Accepts UTC-14:00 through UTC+14:00, not IANA timezone names. Encode + as %2B in URLs. |
competition_idquery | stringOptional | Default: —Example: premier-league | Competition ID. |
Request example
Set the FQ_API_KEY environment variable first. IDs are illustrative; replace them with real IDs returned by list endpoints.
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.
Set FQ_API_KEY to your own key when running this command locally. Empty optional values are omitted.
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.
| Field | Type | Description |
|---|---|---|
id | string | Match ID. |
kickoff_at | string/null | Kickoff time in ISO 8601 format. |
status | string | One of not_started, live, finished, postponed, interrupted, abandoned, cancelled, pending or unknown. |
status_localized | string | English status description. |
competition | object/null | Competition { id, name, logo, slug }. |
home_team | object/null | Home team { id, name, logo, slug }. |
away_team | object/null | Away team { id, name, logo, slug }. |
venue | object/null | Venue { id, name, capacity }. |
score | object | Score breakdown: fulltime, halftime, cards, corners, extratime and penalty. |
round | integer/null | Round number. |
season | object/null | Season summary { id, year }. |
stage | object/null | Stage summary { id, name }. |
status_detail | string | English match phase, such as First half, HT, Second half, FT or AET. |
score.fulltime | object | Current/full-time score. home and away are numbers or null. |
score.halftime | object | Half-time score. home and away are numbers or null. |
score.extratime | object | Extra-time score. home and away are numbers or null. |
score.penalty | object | Penalty shootout score. home and away are numbers or null. |
score.corners | object | Corner counts. home and away are numbers or null. |
score.cards | object | home_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.
{
"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
}
}
}
]
}