Football results API
ResultsFinished matches by date, with the final score.
Results returns every finished football match for a day. Leave out date and you get yesterday, which is also what the free key reads. Each row carries the final score, both sides with their ids and the competition, so one call fills a results page and every id opens the next one.
Try it
Your key stays in this browser and is filled in on every docs page.
200 OK1903 ms2 rows shownReal answer from 2026-11-03, trimmed
{
"data": [
{
"match_id": "fb_3npnahqb09",
"league_id": "fb_9vq1mbqrgz",
"country_name": "Brazil",
"league_name": "Serie B",
"season_start_year": 2026,
"kickoff_utc": "2026-11-02T23:30:00Z",
"kickoff_date": "2026-11-02",
"kickoff_local_date": "2026-11-02",
"kickoff_local_time": "23:30",
"match_status": "finished",
"home_team_id": "fb_mw96mceske",
"home_team_name": "Goias",
"away_team_id": "fb_1cycjasdqh",
"away_team_name": "CRB",
"home_goals": 2,
"away_goals": 1,
"full_time_result": null,
"half_time_home_goals": 1,
"half_time_away_goals": 0,
"half_time_result": null,
"stoppage_minutes": null,
"is_kickoff_rescheduled": false,
"elapsed_minutes": null,
"home_league_position": 17,
"away_league_position": 18,
"away_travel_km": 1662,
"venue_name": "Estádio da Serrinha",
"city_name": "Goiânia",
"latitude": -16.635209,
"longitude": -49.265904,
"location_precision": "ground",
"daylight_minutes": 763,
"sun_elevation_deg": -29.3,
"public_holiday": null,
"kickoff_temperature_c": null,
"kickoff_rain_mm": null,
"kickoff_wind_ms": null,
"attendance": null,
"referee_name": "Felipe Fernandes de Lima",
"kickoff_book_pct": 1.0138,
"regular_time_home_goals": null,
"regular_time_away_goals": null,
"regular_time_result": null,
"extra_time_home_goals": null,
"extra_time_away_goals": null,
"shootout_home_goals": null,
"shootout_away_goals": null,
"statistics_status": null,
"best_odds": {
"home": 2.16,
"draw": 3.8,
"away": 3.55,
"book_pct": 1.0078,
"taken_utc": "2026-11-02T23:25:02Z"
},
"team_figures": null,
"statistics_reason": null
},
{
"match_id": "fb_3mg42m9pyn",
"league_id": "fb_wma271b54d",
"country_name": "Chile",
"league_name": "Primera División",
"season_start_year": 2026,
"kickoff_utc": "2026-11-02T23:30:00Z",
"kickoff_date": "2026-11-02",
"kickoff_local_date": "2026-11-02",
"kickoff_local_time": "23:30",
"match_status": "finished",
"home_team_id": "fb_hny9rc1tkt",
"home_team_name": "Concepción",
"away_team_id": "fb_ws0bbvakw5",
"away_team_name": "Palestino",
"home_goals": 1,
"away_goals": 0,
"full_time_result": null,
"half_time_home_goals": 1,
"half_time_away_goals": 0,
"half_time_result": null,
"stoppage_minutes": null,
"is_kickoff_rescheduled": false,
"elapsed_minutes": null,
"home_league_position": 11,
"away_league_position": 4,
"away_travel_km": 433,
"venue_name": "Estadio Municipal Ester Roa Concepcion",
"city_name": "Concepcion",
"latitude": -36.826944444444,
"longitude": -73.050277777778,
"location_precision": "city",
"daylight_minutes": 819,
"sun_elevation_deg": -1.7,
"public_holiday": null,
"kickoff_temperature_c": null,
"kickoff_rain_mm": null,
"kickoff_wind_ms": null,
"attendance": null,
"referee_name": null,
"kickoff_book_pct": 1.0148,
"regular_time_home_goals": null,
"regular_time_away_goals": null,
"regular_time_result": null,
"extra_time_home_goals": null,
"extra_time_away_goals": null,
"shootout_home_goals": null,
"shootout_away_goals": null,
"statistics_status": null,
"best_odds": {
"home": 2.76,
"draw": 3.5,
"away": 2.74,
"book_pct": 1.013,
"taken_utc": "2026-11-02T23:25:02Z"
},
"team_figures": null,
"statistics_reason": null
}
],
"meta": {
"sport": "football",
"endpoint": "/results",
"count": 100,
"page": 1,
"per_page": 100,
"total": 229,
"total_pages": 3,
"next_cursor": "MTc5MzYzODgwMDoxNTU1MjAw",
"next_page": 2,
"prev_page": null,
"as_of": "2026-11-02T05:16:53Z",
"cached": false,
"age_seconds": 0
}
}No key yet? Get a free key: it reads yesterday for every sport and is filled in here once made.
Parameters
Query values this call takes. Anything else is refused with bad_param and the list it accepts.
| Name | Type | What it does | |
|---|---|---|---|
| date | date | optional | One day, written YYYY-MM-DD. Leave it out for the default day. The free key reads yesterday only. |
| competition | id | optional | Only this competition, by its id from Competitions. |
| page | integer | optional | Which page of rows, from 1. |
| per_page | integer | optional | Rows per page, up to 100 on most lists. |
Returns
Each row of data, from a real answer. Every id is ours and opens its own endpoint.
| Field | Type | What it holds |
|---|---|---|
| match_id | id | The match, by our id |
| league_id | id | The competition, by our id |
| country_name | string | Where it is played |
| league_name | string | The competition |
| season_start_year | integer | The year the season started |
| kickoff_utc | datetime | Kick-off time in UTC |
| kickoff_date | date | Kickoff date |
| kickoff_local_date | date | Kickoff local date |
| kickoff_local_time | string | Kickoff local time |
| match_status | string | The match state |
| home_team_id | id | The home side, by our id |
| home_team_name | string | The home side |
| away_team_id | id | The away side, by our id |
| away_team_name | string | The away side |
| home_goals | integer | Home goals at full time |
| away_goals | integer | Away goals at full time |
| full_time_result | null | H, D or A at full time |
| half_time_home_goals | integer | Home goals at half-time |
| half_time_away_goals | integer | Away goals at half-time |
| half_time_result | null | H, D or A at half-time |
| stoppage_minutes | null | Stoppage in metresinutes |
| is_kickoff_rescheduled | boolean | Is kickoff rescheduled |
| elapsed_minutes | null | Elapsed in metresinutes |
| home_league_position | integer | Home league position |
| away_league_position | integer | Away league position |
| away_travel_km | integer | Away travel km |
| venue_name | string | The ground |
| city_name | string | The city |
| latitude | number | Latitude of the ground |
| longitude | number | Longitude of the ground |
| location_precision | string | Location precision |
| daylight_minutes | integer | Daylight in metresinutes |
| sun_elevation_deg | number | Sun elevation deg |
| public_holiday | null | Public holiday |
| kickoff_temperature_c | null | Kickoff temperature c |
| kickoff_rain_mm | null | Kickoff rain in metresm |
| kickoff_wind_ms | null | Kickoff wind in metress |
| attendance | null | Attendance |
| referee_name | string | Referee name |
| kickoff_book_pct | number | Kickoff book percent |
| regular_time_home_goals | null | Regular time home goals |
| regular_time_away_goals | null | Regular time away goals |
| regular_time_result | null | Regular time result |
| extra_time_home_goals | null | Extra time home goals |
| extra_time_away_goals | null | Extra time away goals |
| shootout_home_goals | null | Shootout home goals |
| shootout_away_goals | null | Shootout away goals |
| statistics_status | null | Statistics status |
| best_odds | object | Best odds |
| team_figures | null | Team figures |
| statistics_reason | null | Statistics reason |
| meta | What it holds |
|---|---|
| sport, endpoint | What you asked |
| count | Rows in this answer |
| page, per_page, total, next_cursor | Where you are in a paged list, when it is paged |
| as_of | When the data was built |
| cached, age_seconds | Whether this is a stored copy, and its age |
| access | On the free key: what it reads, and the plan that opens the rest |
Errors
Codes this call can give. Each is explained in Errors.
| Status | Code | When |
|---|---|---|
| 401 | no_key | No key sent, or not in a form we read |
| 401 | bad_key | A key we do not know |
| 403 | plan | The free key asked for a date other than yesterday |
| 422 | bad_param | A value this call does not take |
| 429 | rate | Over the calls a minute for your plan |
| 503 | upstream | The data is not answering; retry after Retry-After |
The free key reads yesterday. The Football plan opens live, fixtures and every date held, for $79 a month.
Add Football