api-football
API-FOOTBALL is a comprehensive API service providing extensive data related to football leagues, teams, players, and matches.
v3_timezone
Get the list of available timezone to be used in the fixtures endpoint. > This endpoint does not require any parameters. **Update Frequency** : This endpoint contains all the existing timezone, it is not updated. **Recommended Calls** : 1 call when you need.
Try it
Result:
v3_predictions
Get predictions about a fixture. The predictions are made using several algorithms including the poisson distribution, comparison of team statistics, last matches, players etc… Bookmakers odds are not used to make these predictions Also provides some comparative statistics between teams **Available Predictions** * Match winner : Id of the team that can potentially win the fixture * Win or Draw : If `True` indicates that the designated team can win or draw * Under / Over : -1.5 / -2.5 / -3.5 / -4.5 / +1.5 / +2.5 / +3.5 / +4.5 `*` * Goals Home : -1.5 / -2.5 / -3.5 / -4.5 `*` * Goals Away -1.5 / -2.5 / -3.5 / -4.5 `*` * Advice *(Ex : Deportivo Santani or draws and -3.5 goals)* `*` **-1.5** means that there will be a maximum of **1.5** goals in the fixture, i.e : **1** goal **Update Frequency** : This endpoint is updated every hour. **Recommended Calls** : 1 call per hour for the fixtures in progress otherwise 1 call per day. >Here is an example of what can be achieved  **Use Cases** Get all available predictions from one {fixture} `https://api-football-v1.p.rapidapi.com/v3/predictions?fixture=198772`
Try it
Result:
v3_fixtures_head_to_head_between_two_teams
Get heads to heads between two teams. **Update Frequency** : This endpoint is updated every 15 seconds. **Recommended Calls** : 1 call per minute for the leagues, teams, fixtures who have at least one fixture in progress otherwise 1 call per day. > Here is an example of what can be achieved  **Use Cases** Get all head to head between two {team} `https://api-football-v1.p.rapidapi.com/v3/fixtures/headtohead?h2h=33-34` It’s possible to make requests by mixing the available parameters `https://api-football-v1.p.rapidapi.com/v3/fixtures/headtohead?h2h=33-34` `https://api-football-v1.p.rapidapi.com/v3/fixtures/headtohead?h2h=33-34&status=ns` `https://api-football-v1.p.rapidapi.com/v3/fixtures/headtohead?h2h=33-34&from=2019-10-01&to=2019-10-31` `https://api-football-v1.p.rapidapi.com/v3/fixtures/headtohead?league=39&season=2019&h2h=33-34&last=5` `https://api-football-v1.p.rapidapi.com/v3/fixtures/headtohead?league=39&season=2019&h2h=33-34&next=10&from=2019-10-01&to=2019-10-31` `https://api-football-v1.p.rapidapi.com/v3/fixtures/headtohead?league=39&season=2019&h2h=33-34&last=5&timezone=Europe/London`
Try it
Result:
v3_fixtures
For all requests to fixtures you can add the query parameter `timezone` to your request in order to retrieve the list of matches in the time zone of your choice like *“Europe/London“* To know the list of available time zones you have to use the endpoint `timezone` > Some leagues have only final result check our coverage page to know which ones **Available fixtures status** * TBD : Time To Be Defined * NS : Not Started * 1H : First Half, Kick Off * HT : Halftime * 2H : Second Half, 2nd Half Started * ET : Extra Time * P : Penalty In Progress * FT : Match Finished * AET : Match Finished After Extra Time * PEN : Match Finished After Penalty * BT : Break Time (in Extra Time) * SUSP : Match Suspended * INT : Match Interrupted * PST : Match Postponed * CANC : Match Cancelled * ABD : Match Abandoned * AWD : Technical Loss * WO : WalkOver **Update Frequency** : This endpoint is updated every 15 seconds. **Recommended Calls** : 1 call per minute for the leagues, teams, fixtures who have at least one fixture in progress otherwise 1 call per day. > Here are several examples of what can be achieved  **Use Cases** Get fixture from one fixture {id} In this request events, lineups, statistics fixture and players fixture are returned in the response `https://api-football-v1.p.rapidapi.com/v3/fixtures?id=215662` Get fixture from severals fixtures {ids} In this request events, lineups, statistics fixture and players fixture are returned in the response `https://api-football-v1.p.rapidapi.com/v3/fixtures?ids=215662-215663-215664-215665-215666-215667` Get all available fixtures in play In this request events are returned in the response `https://api-football-v1.p.rapidapi.com/v3/fixtures?live=all` Get all available fixtures in play filter by several {league} In this request events are returned in the response `https://api-football-v1.p.rapidapi.com/v3/fixtures?live=39-61-48` Get all available fixtures from one {league} & {season} `https://api-football-v1.p.rapidapi.com/v3/fixtures?league=39&season=2019` Get all available fixtures from one {date} `https://api-football-v1.p.rapidapi.com/v3/fixtures?date=2019-10-22` Get next X available fixtures `https://api-football-v1.p.rapidapi.com/v3/fixtures?next=15` Get last X available fixtures `https://api-football-v1.p.rapidapi.com/v3/fixtures?last=15` It’s possible to make requests by mixing the available parameters `https://api-football-v1.p.rapidapi.com/v3/fixtures?date=2020-01-30&league=61&season=2019` `https://api-football-v1.p.rapidapi.com/v3/fixtures?league=61&next=10` `https://api-football-v1.p.rapidapi.com/v3/fixtures?league=61&last=10&status=ft` `https://api-football-v1.p.rapidapi.com/v3/fixtures?team=85&last=10&timezone=Europe/london` `https://api-football-v1.p.rapidapi.com/v3/fixtures?team=85&season=2019&from=2019-07-01&to=2020-10-31` `https://api-football-v1.p.rapidapi.com/v3/fixtures?league=61&season=2019&from=2019-07-01&to=2020-10-31&timezone=Europe/london` `https://api-football-v1.p.rapidapi.com/v3/fixtures?league=61&season=2019&round=Regular Season - 1`
Try it
Result:
v3_fixtures_rounds
Get the rounds for a league or a cup. The `round` can be used in endpoint fixtures as filters **Update Frequency** : This endpoint is updated every day. **Recommended Calls** : 1 call per day. **Use Cases** Get all available rounds from one {league} & {season} `https://api-football-v1.p.rapidapi.com/v3/rounds?league=39&season=2019` Get current round from one {league} & {season} `https://api-football-v1.p.rapidapi.com/v3/rounds?league=39&season=2019¤t=true`
Try it
Result:
v3_fixtures_current_round
Get the rounds for a league or a cup. The `round` can be used in endpoint fixtures as filters **Update Frequency** : This endpoint is updated every day. **Recommended Calls** : 1 call per day. **Use Cases** Get all available rounds from one {league} & {season} `https://api-football-v1.p.rapidapi.com/v3/rounds?league=39&season=2019` Get current round from one {league} & {season} `https://api-football-v1.p.rapidapi.com/v3/rounds?league=39&season=2019¤t=true`
Try it
Result:
v3_fixtures_by_fixture_id
For all requests to fixtures you can add the query parameter `timezone` to your request in order to retrieve the list of matches in the time zone of your choice like *“Europe/London“* To know the list of available time zones you have to use the endpoint `timezone` > Some leagues have only final result check our coverage page to know which ones **Available fixtures status** * TBD : Time To Be Defined * NS : Not Started * 1H : First Half, Kick Off * HT : Halftime * 2H : Second Half, 2nd Half Started * ET : Extra Time * P : Penalty In Progress * FT : Match Finished * AET : Match Finished After Extra Time * PEN : Match Finished After Penalty * BT : Break Time (in Extra Time) * SUSP : Match Suspended * INT : Match Interrupted * PST : Match Postponed * CANC : Match Cancelled * ABD : Match Abandoned * AWD : Technical Loss * WO : WalkOver **Update Frequency** : This endpoint is updated every 15 seconds. **Recommended Calls** : 1 call per minute for the leagues, teams, fixtures who have at least one fixture in progress otherwise 1 call per day. > Here are several examples of what can be achieved  **Use Cases** Get fixture from one fixture {id} In this request events, lineups, statistics fixture and players fixture are returned in the response `https://api-football-v1.p.rapidapi.com/v3/fixtures?id=215662` Get fixture from severals fixtures {ids} In this request events, lineups, statistics fixture and players fixture are returned in the response `https://api-football-v1.p.rapidapi.com/v3/fixtures?ids=215662-215663-215664-215665-215666-215667` Get all available fixtures in play In this request events are returned in the response `https://api-football-v1.p.rapidapi.com/v3/fixtures?live=all` Get all available fixtures in play filter by several {league} In this request events are returned in the response `https://api-football-v1.p.rapidapi.com/v3/fixtures?live=39-61-48` Get all available fixtures from one {league} & {season} `https://api-football-v1.p.rapidapi.com/v3/fixtures?league=39&season=2019` Get all available fixtures from one {date} `https://api-football-v1.p.rapidapi.com/v3/fixtures?date=2019-10-22` Get next X available fixtures `https://api-football-v1.p.rapidapi.com/v3/fixtures?next=15` Get last X available fixtures `https://api-football-v1.p.rapidapi.com/v3/fixtures?last=15` It’s possible to make requests by mixing the available parameters `https://api-football-v1.p.rapidapi.com/v3/fixtures?date=2020-01-30&league=61&season=2019` `https://api-football-v1.p.rapidapi.com/v3/fixtures?league=61&next=10` `https://api-football-v1.p.rapidapi.com/v3/fixtures?league=61&last=10&status=ft` `https://api-football-v1.p.rapidapi.com/v3/fixtures?team=85&last=10&timezone=Europe/london` `https://api-football-v1.p.rapidapi.com/v3/fixtures?team=85&season=2019&from=2019-07-01&to=2020-10-31` `https://api-football-v1.p.rapidapi.com/v3/fixtures?league=61&season=2019&from=2019-07-01&to=2020-10-31&timezone=Europe/london` `https://api-football-v1.p.rapidapi.com/v3/fixtures?league=61&season=2019&round=Regular Season - 1`
Try it
Result:
v3_fixtures_in_progress
For all requests to fixtures you can add the query parameter `timezone` to your request in order to retrieve the list of matches in the time zone of your choice like *“Europe/London“* To know the list of available time zones you have to use the endpoint `timezone` > Some leagues have only final result check our coverage page to know which ones **Available fixtures status** * TBD : Time To Be Defined * NS : Not Started * 1H : First Half, Kick Off * HT : Halftime * 2H : Second Half, 2nd Half Started * ET : Extra Time * P : Penalty In Progress * FT : Match Finished * AET : Match Finished After Extra Time * PEN : Match Finished After Penalty * BT : Break Time (in Extra Time) * SUSP : Match Suspended * INT : Match Interrupted * PST : Match Postponed * CANC : Match Cancelled * ABD : Match Abandoned * AWD : Technical Loss * WO : WalkOver **Update Frequency** : This endpoint is updated every 15 seconds. **Recommended Calls** : 1 call per minute for the leagues, teams, fixtures who have at least one fixture in progress otherwise 1 call per day. > Here are several examples of what can be achieved  **Use Cases** Get fixture from one fixture {id} In this request events, lineups, statistics fixture and players fixture are returned in the response `https://api-football-v1.p.rapidapi.com/v3/fixtures?id=215662` Get fixture from severals fixtures {ids} In this request events, lineups, statistics fixture and players fixture are returned in the response `https://api-football-v1.p.rapidapi.com/v3/fixtures?ids=215662-215663-215664-215665-215666-215667` Get all available fixtures in play In this request events are returned in the response `https://api-football-v1.p.rapidapi.com/v3/fixtures?live=all` Get all available fixtures in play filter by several {league} In this request events are returned in the response `https://api-football-v1.p.rapidapi.com/v3/fixtures?live=39-61-48` Get all available fixtures from one {league} & {season} `https://api-football-v1.p.rapidapi.com/v3/fixtures?league=39&season=2019` Get all available fixtures from one {date} `https://api-football-v1.p.rapidapi.com/v3/fixtures?date=2019-10-22` Get next X available fixtures `https://api-football-v1.p.rapidapi.com/v3/fixtures?next=15` Get last X available fixtures `https://api-football-v1.p.rapidapi.com/v3/fixtures?last=15` It’s possible to make requests by mixing the available parameters `https://api-football-v1.p.rapidapi.com/v3/fixtures?date=2020-01-30&league=61&season=2019` `https://api-football-v1.p.rapidapi.com/v3/fixtures?league=61&next=10` `https://api-football-v1.p.rapidapi.com/v3/fixtures?league=61&last=10&status=ft` `https://api-football-v1.p.rapidapi.com/v3/fixtures?team=85&last=10&timezone=Europe/london` `https://api-football-v1.p.rapidapi.com/v3/fixtures?team=85&season=2019&from=2019-07-01&to=2020-10-31` `https://api-football-v1.p.rapidapi.com/v3/fixtures?league=61&season=2019&from=2019-07-01&to=2020-10-31&timezone=Europe/london` `https://api-football-v1.p.rapidapi.com/v3/fixtures?league=61&season=2019&round=Regular Season - 1`
Try it
Result:
v3_fixtures_by_date
For all requests to fixtures you can add the query parameter `timezone` to your request in order to retrieve the list of matches in the time zone of your choice like *“Europe/London“* To know the list of available time zones you have to use the endpoint `timezone` > Some leagues have only final result check our coverage page to know which ones **Available fixtures status** * TBD : Time To Be Defined * NS : Not Started * 1H : First Half, Kick Off * HT : Halftime * 2H : Second Half, 2nd Half Started * ET : Extra Time * P : Penalty In Progress * FT : Match Finished * AET : Match Finished After Extra Time * PEN : Match Finished After Penalty * BT : Break Time (in Extra Time) * SUSP : Match Suspended * INT : Match Interrupted * PST : Match Postponed * CANC : Match Cancelled * ABD : Match Abandoned * AWD : Technical Loss * WO : WalkOver **Update Frequency** : This endpoint is updated every 15 seconds. **Recommended Calls** : 1 call per minute for the leagues, teams, fixtures who have at least one fixture in progress otherwise 1 call per day. > Here are several examples of what can be achieved  **Use Cases** Get fixture from one fixture {id} In this request events, lineups, statistics fixture and players fixture are returned in the response `https://api-football-v1.p.rapidapi.com/v3/fixtures?id=215662` Get fixture from severals fixtures {ids} In this request events, lineups, statistics fixture and players fixture are returned in the response `https://api-football-v1.p.rapidapi.com/v3/fixtures?ids=215662-215663-215664-215665-215666-215667` Get all available fixtures in play In this request events are returned in the response `https://api-football-v1.p.rapidapi.com/v3/fixtures?live=all` Get all available fixtures in play filter by several {league} In this request events are returned in the response `https://api-football-v1.p.rapidapi.com/v3/fixtures?live=39-61-48` Get all available fixtures from one {league} & {season} `https://api-football-v1.p.rapidapi.com/v3/fixtures?league=39&season=2019` Get all available fixtures from one {date} `https://api-football-v1.p.rapidapi.com/v3/fixtures?date=2019-10-22` Get next X available fixtures `https://api-football-v1.p.rapidapi.com/v3/fixtures?next=15` Get last X available fixtures `https://api-football-v1.p.rapidapi.com/v3/fixtures?last=15` It’s possible to make requests by mixing the available parameters `https://api-football-v1.p.rapidapi.com/v3/fixtures?date=2020-01-30&league=61&season=2019` `https://api-football-v1.p.rapidapi.com/v3/fixtures?league=61&next=10` `https://api-football-v1.p.rapidapi.com/v3/fixtures?league=61&last=10&status=ft` `https://api-football-v1.p.rapidapi.com/v3/fixtures?team=85&last=10&timezone=Europe/london` `https://api-football-v1.p.rapidapi.com/v3/fixtures?team=85&season=2019&from=2019-07-01&to=2020-10-31` `https://api-football-v1.p.rapidapi.com/v3/fixtures?league=61&season=2019&from=2019-07-01&to=2020-10-31&timezone=Europe/london` `https://api-football-v1.p.rapidapi.com/v3/fixtures?league=61&season=2019&round=Regular Season - 1`
Try it
Result:
v3_fixtures_by_league_id
For all requests to fixtures you can add the query parameter `timezone` to your request in order to retrieve the list of matches in the time zone of your choice like *“Europe/London“* To know the list of available time zones you have to use the endpoint `timezone` > Some leagues have only final result check our coverage page to know which ones **Available fixtures status** * TBD : Time To Be Defined * NS : Not Started * 1H : First Half, Kick Off * HT : Halftime * 2H : Second Half, 2nd Half Started * ET : Extra Time * P : Penalty In Progress * FT : Match Finished * AET : Match Finished After Extra Time * PEN : Match Finished After Penalty * BT : Break Time (in Extra Time) * SUSP : Match Suspended * INT : Match Interrupted * PST : Match Postponed * CANC : Match Cancelled * ABD : Match Abandoned * AWD : Technical Loss * WO : WalkOver **Update Frequency** : This endpoint is updated every 15 seconds. **Recommended Calls** : 1 call per minute for the leagues, teams, fixtures who have at least one fixture in progress otherwise 1 call per day. > Here are several examples of what can be achieved  **Use Cases** Get fixture from one fixture {id} In this request events, lineups, statistics fixture and players fixture are returned in the response `https://api-football-v1.p.rapidapi.com/v3/fixtures?id=215662` Get fixture from severals fixtures {ids} In this request events, lineups, statistics fixture and players fixture are returned in the response `https://api-football-v1.p.rapidapi.com/v3/fixtures?ids=215662-215663-215664-215665-215666-215667` Get all available fixtures in play In this request events are returned in the response `https://api-football-v1.p.rapidapi.com/v3/fixtures?live=all` Get all available fixtures in play filter by several {league} In this request events are returned in the response `https://api-football-v1.p.rapidapi.com/v3/fixtures?live=39-61-48` Get all available fixtures from one {league} & {season} `https://api-football-v1.p.rapidapi.com/v3/fixtures?league=39&season=2019` Get all available fixtures from one {date} `https://api-football-v1.p.rapidapi.com/v3/fixtures?date=2019-10-22` Get next X available fixtures `https://api-football-v1.p.rapidapi.com/v3/fixtures?next=15` Get last X available fixtures `https://api-football-v1.p.rapidapi.com/v3/fixtures?last=15` It’s possible to make requests by mixing the available parameters `https://api-football-v1.p.rapidapi.com/v3/fixtures?date=2020-01-30&league=61&season=2019` `https://api-football-v1.p.rapidapi.com/v3/fixtures?league=61&next=10` `https://api-football-v1.p.rapidapi.com/v3/fixtures?league=61&last=10&status=ft` `https://api-football-v1.p.rapidapi.com/v3/fixtures?team=85&last=10&timezone=Europe/london` `https://api-football-v1.p.rapidapi.com/v3/fixtures?team=85&season=2019&from=2019-07-01&to=2020-10-31` `https://api-football-v1.p.rapidapi.com/v3/fixtures?league=61&season=2019&from=2019-07-01&to=2020-10-31&timezone=Europe/london` `https://api-football-v1.p.rapidapi.com/v3/fixtures?league=61&season=2019&round=Regular Season - 1`
Try it
Result:
v3_fixtures_by_team_id
For all requests to fixtures you can add the query parameter `timezone` to your request in order to retrieve the list of matches in the time zone of your choice like *“Europe/London“* To know the list of available time zones you have to use the endpoint `timezone` > Some leagues have only final result check our coverage page to know which ones **Available fixtures status** * TBD : Time To Be Defined * NS : Not Started * 1H : First Half, Kick Off * HT : Halftime * 2H : Second Half, 2nd Half Started * ET : Extra Time * P : Penalty In Progress * FT : Match Finished * AET : Match Finished After Extra Time * PEN : Match Finished After Penalty * BT : Break Time (in Extra Time) * SUSP : Match Suspended * INT : Match Interrupted * PST : Match Postponed * CANC : Match Cancelled * ABD : Match Abandoned * AWD : Technical Loss * WO : WalkOver **Update Frequency** : This endpoint is updated every 15 seconds. **Recommended Calls** : 1 call per minute for the leagues, teams, fixtures who have at least one fixture in progress otherwise 1 call per day. > Here are several examples of what can be achieved  **Use Cases** Get fixture from one fixture {id} In this request events, lineups, statistics fixture and players fixture are returned in the response `https://api-football-v1.p.rapidapi.com/v3/fixtures?id=215662` Get fixture from severals fixtures {ids} In this request events, lineups, statistics fixture and players fixture are returned in the response `https://api-football-v1.p.rapidapi.com/v3/fixtures?ids=215662-215663-215664-215665-215666-215667` Get all available fixtures in play In this request events are returned in the response `https://api-football-v1.p.rapidapi.com/v3/fixtures?live=all` Get all available fixtures in play filter by several {league} In this request events are returned in the response `https://api-football-v1.p.rapidapi.com/v3/fixtures?live=39-61-48` Get all available fixtures from one {league} & {season} `https://api-football-v1.p.rapidapi.com/v3/fixtures?league=39&season=2019` Get all available fixtures from one {date} `https://api-football-v1.p.rapidapi.com/v3/fixtures?date=2019-10-22` Get next X available fixtures `https://api-football-v1.p.rapidapi.com/v3/fixtures?next=15` Get last X available fixtures `https://api-football-v1.p.rapidapi.com/v3/fixtures?last=15` It’s possible to make requests by mixing the available parameters `https://api-football-v1.p.rapidapi.com/v3/fixtures?date=2020-01-30&league=61&season=2019` `https://api-football-v1.p.rapidapi.com/v3/fixtures?league=61&next=10` `https://api-football-v1.p.rapidapi.com/v3/fixtures?league=61&last=10&status=ft` `https://api-football-v1.p.rapidapi.com/v3/fixtures?team=85&last=10&timezone=Europe/london` `https://api-football-v1.p.rapidapi.com/v3/fixtures?team=85&season=2019&from=2019-07-01&to=2020-10-31` `https://api-football-v1.p.rapidapi.com/v3/fixtures?league=61&season=2019&from=2019-07-01&to=2020-10-31&timezone=Europe/london` `https://api-football-v1.p.rapidapi.com/v3/fixtures?league=61&season=2019&round=Regular Season - 1`
Try it
Result:
v3_fixtures_between_two_dates
For all requests to fixtures you can add the query parameter `timezone` to your request in order to retrieve the list of matches in the time zone of your choice like *“Europe/London“* To know the list of available time zones you have to use the endpoint `timezone` > Some leagues have only final result check our coverage page to know which ones **Available fixtures status** * TBD : Time To Be Defined * NS : Not Started * 1H : First Half, Kick Off * HT : Halftime * 2H : Second Half, 2nd Half Started * ET : Extra Time * P : Penalty In Progress * FT : Match Finished * AET : Match Finished After Extra Time * PEN : Match Finished After Penalty * BT : Break Time (in Extra Time) * SUSP : Match Suspended * INT : Match Interrupted * PST : Match Postponed * CANC : Match Cancelled * ABD : Match Abandoned * AWD : Technical Loss * WO : WalkOver **Update Frequency** : This endpoint is updated every 15 seconds. **Recommended Calls** : 1 call per minute for the leagues, teams, fixtures who have at least one fixture in progress otherwise 1 call per day. > Here are several examples of what can be achieved  **Use Cases** Get fixture from one fixture {id} In this request events, lineups, statistics fixture and players fixture are returned in the response `https://api-football-v1.p.rapidapi.com/v3/fixtures?id=215662` Get fixture from severals fixtures {ids} In this request events, lineups, statistics fixture and players fixture are returned in the response `https://api-football-v1.p.rapidapi.com/v3/fixtures?ids=215662-215663-215664-215665-215666-215667` Get all available fixtures in play In this request events are returned in the response `https://api-football-v1.p.rapidapi.com/v3/fixtures?live=all` Get all available fixtures in play filter by several {league} In this request events are returned in the response `https://api-football-v1.p.rapidapi.com/v3/fixtures?live=39-61-48` Get all available fixtures from one {league} & {season} `https://api-football-v1.p.rapidapi.com/v3/fixtures?league=39&season=2019` Get all available fixtures from one {date} `https://api-football-v1.p.rapidapi.com/v3/fixtures?date=2019-10-22` Get next X available fixtures `https://api-football-v1.p.rapidapi.com/v3/fixtures?next=15` Get last X available fixtures `https://api-football-v1.p.rapidapi.com/v3/fixtures?last=15` It’s possible to make requests by mixing the available parameters `https://api-football-v1.p.rapidapi.com/v3/fixtures?date=2020-01-30&league=61&season=2019` `https://api-football-v1.p.rapidapi.com/v3/fixtures?league=61&next=10` `https://api-football-v1.p.rapidapi.com/v3/fixtures?league=61&last=10&status=ft` `https://api-football-v1.p.rapidapi.com/v3/fixtures?team=85&last=10&timezone=Europe/london` `https://api-football-v1.p.rapidapi.com/v3/fixtures?team=85&season=2019&from=2019-07-01&to=2020-10-31` `https://api-football-v1.p.rapidapi.com/v3/fixtures?league=61&season=2019&from=2019-07-01&to=2020-10-31&timezone=Europe/london` `https://api-football-v1.p.rapidapi.com/v3/fixtures?league=61&season=2019&round=Regular Season - 1`
Try it
Result:
v3_fixtures_filtered_by_round
For all requests to fixtures you can add the query parameter `timezone` to your request in order to retrieve the list of matches in the time zone of your choice like *“Europe/London“* To know the list of available time zones you have to use the endpoint `timezone` > Some leagues have only final result check our coverage page to know which ones **Available fixtures status** * TBD : Time To Be Defined * NS : Not Started * 1H : First Half, Kick Off * HT : Halftime * 2H : Second Half, 2nd Half Started * ET : Extra Time * P : Penalty In Progress * FT : Match Finished * AET : Match Finished After Extra Time * PEN : Match Finished After Penalty * BT : Break Time (in Extra Time) * SUSP : Match Suspended * INT : Match Interrupted * PST : Match Postponed * CANC : Match Cancelled * ABD : Match Abandoned * AWD : Technical Loss * WO : WalkOver **Update Frequency** : This endpoint is updated every 15 seconds. **Recommended Calls** : 1 call per minute for the leagues, teams, fixtures who have at least one fixture in progress otherwise 1 call per day. > Here are several examples of what can be achieved  **Use Cases** Get fixture from one fixture {id} In this request events, lineups, statistics fixture and players fixture are returned in the response `https://api-football-v1.p.rapidapi.com/v3/fixtures?id=215662` Get fixture from severals fixtures {ids} In this request events, lineups, statistics fixture and players fixture are returned in the response `https://api-football-v1.p.rapidapi.com/v3/fixtures?ids=215662-215663-215664-215665-215666-215667` Get all available fixtures in play In this request events are returned in the response `https://api-football-v1.p.rapidapi.com/v3/fixtures?live=all` Get all available fixtures in play filter by several {league} In this request events are returned in the response `https://api-football-v1.p.rapidapi.com/v3/fixtures?live=39-61-48` Get all available fixtures from one {league} & {season} `https://api-football-v1.p.rapidapi.com/v3/fixtures?league=39&season=2019` Get all available fixtures from one {date} `https://api-football-v1.p.rapidapi.com/v3/fixtures?date=2019-10-22` Get next X available fixtures `https://api-football-v1.p.rapidapi.com/v3/fixtures?next=15` Get last X available fixtures `https://api-football-v1.p.rapidapi.com/v3/fixtures?last=15` It’s possible to make requests by mixing the available parameters `https://api-football-v1.p.rapidapi.com/v3/fixtures?date=2020-01-30&league=61&season=2019` `https://api-football-v1.p.rapidapi.com/v3/fixtures?league=61&next=10` `https://api-football-v1.p.rapidapi.com/v3/fixtures?league=61&last=10&status=ft` `https://api-football-v1.p.rapidapi.com/v3/fixtures?team=85&last=10&timezone=Europe/london` `https://api-football-v1.p.rapidapi.com/v3/fixtures?team=85&season=2019&from=2019-07-01&to=2020-10-31` `https://api-football-v1.p.rapidapi.com/v3/fixtures?league=61&season=2019&from=2019-07-01&to=2020-10-31&timezone=Europe/london` `https://api-football-v1.p.rapidapi.com/v3/fixtures?league=61&season=2019&round=Regular Season - 1`
Try it
Result:
v3_fixtures_filtered_by_status
For all requests to fixtures you can add the query parameter `timezone` to your request in order to retrieve the list of matches in the time zone of your choice like *“Europe/London“* To know the list of available time zones you have to use the endpoint `timezone` > Some leagues have only final result check our coverage page to know which ones **Available fixtures status** * TBD : Time To Be Defined * NS : Not Started * 1H : First Half, Kick Off * HT : Halftime * 2H : Second Half, 2nd Half Started * ET : Extra Time * P : Penalty In Progress * FT : Match Finished * AET : Match Finished After Extra Time * PEN : Match Finished After Penalty * BT : Break Time (in Extra Time) * SUSP : Match Suspended * INT : Match Interrupted * PST : Match Postponed * CANC : Match Cancelled * ABD : Match Abandoned * AWD : Technical Loss * WO : WalkOver **Update Frequency** : This endpoint is updated every 15 seconds. **Recommended Calls** : 1 call per minute for the leagues, teams, fixtures who have at least one fixture in progress otherwise 1 call per day. > Here are several examples of what can be achieved  **Use Cases** Get fixture from one fixture {id} In this request events, lineups, statistics fixture and players fixture are returned in the response `https://api-football-v1.p.rapidapi.com/v3/fixtures?id=215662` Get fixture from severals fixtures {ids} In this request events, lineups, statistics fixture and players fixture are returned in the response `https://api-football-v1.p.rapidapi.com/v3/fixtures?ids=215662-215663-215664-215665-215666-215667` Get all available fixtures in play In this request events are returned in the response `https://api-football-v1.p.rapidapi.com/v3/fixtures?live=all` Get all available fixtures in play filter by several {league} In this request events are returned in the response `https://api-football-v1.p.rapidapi.com/v3/fixtures?live=39-61-48` Get all available fixtures from one {league} & {season} `https://api-football-v1.p.rapidapi.com/v3/fixtures?league=39&season=2019` Get all available fixtures from one {date} `https://api-football-v1.p.rapidapi.com/v3/fixtures?date=2019-10-22` Get next X available fixtures `https://api-football-v1.p.rapidapi.com/v3/fixtures?next=15` Get last X available fixtures `https://api-football-v1.p.rapidapi.com/v3/fixtures?last=15` It’s possible to make requests by mixing the available parameters `https://api-football-v1.p.rapidapi.com/v3/fixtures?date=2020-01-30&league=61&season=2019` `https://api-football-v1.p.rapidapi.com/v3/fixtures?league=61&next=10` `https://api-football-v1.p.rapidapi.com/v3/fixtures?league=61&last=10&status=ft` `https://api-football-v1.p.rapidapi.com/v3/fixtures?team=85&last=10&timezone=Europe/london` `https://api-football-v1.p.rapidapi.com/v3/fixtures?team=85&season=2019&from=2019-07-01&to=2020-10-31` `https://api-football-v1.p.rapidapi.com/v3/fixtures?league=61&season=2019&from=2019-07-01&to=2020-10-31&timezone=Europe/london` `https://api-football-v1.p.rapidapi.com/v3/fixtures?league=61&season=2019&round=Regular Season - 1`
Try it
Result:
v3_next_xfixtures_to_come
For all requests to fixtures you can add the query parameter `timezone` to your request in order to retrieve the list of matches in the time zone of your choice like *“Europe/London“* To know the list of available time zones you have to use the endpoint `timezone` > Some leagues have only final result check our coverage page to know which ones **Available fixtures status** * TBD : Time To Be Defined * NS : Not Started * 1H : First Half, Kick Off * HT : Halftime * 2H : Second Half, 2nd Half Started * ET : Extra Time * P : Penalty In Progress * FT : Match Finished * AET : Match Finished After Extra Time * PEN : Match Finished After Penalty * BT : Break Time (in Extra Time) * SUSP : Match Suspended * INT : Match Interrupted * PST : Match Postponed * CANC : Match Cancelled * ABD : Match Abandoned * AWD : Technical Loss * WO : WalkOver **Update Frequency** : This endpoint is updated every 15 seconds. **Recommended Calls** : 1 call per minute for the leagues, teams, fixtures who have at least one fixture in progress otherwise 1 call per day. > Here are several examples of what can be achieved  **Use Cases** Get fixture from one fixture {id} In this request events, lineups, statistics fixture and players fixture are returned in the response `https://api-football-v1.p.rapidapi.com/v3/fixtures?id=215662` Get fixture from severals fixtures {ids} In this request events, lineups, statistics fixture and players fixture are returned in the response `https://api-football-v1.p.rapidapi.com/v3/fixtures?ids=215662-215663-215664-215665-215666-215667` Get all available fixtures in play In this request events are returned in the response `https://api-football-v1.p.rapidapi.com/v3/fixtures?live=all` Get all available fixtures in play filter by several {league} In this request events are returned in the response `https://api-football-v1.p.rapidapi.com/v3/fixtures?live=39-61-48` Get all available fixtures from one {league} & {season} `https://api-football-v1.p.rapidapi.com/v3/fixtures?league=39&season=2019` Get all available fixtures from one {date} `https://api-football-v1.p.rapidapi.com/v3/fixtures?date=2019-10-22` Get next X available fixtures `https://api-football-v1.p.rapidapi.com/v3/fixtures?next=15` Get last X available fixtures `https://api-football-v1.p.rapidapi.com/v3/fixtures?last=15` It’s possible to make requests by mixing the available parameters `https://api-football-v1.p.rapidapi.com/v3/fixtures?date=2020-01-30&league=61&season=2019` `https://api-football-v1.p.rapidapi.com/v3/fixtures?league=61&next=10` `https://api-football-v1.p.rapidapi.com/v3/fixtures?league=61&last=10&status=ft` `https://api-football-v1.p.rapidapi.com/v3/fixtures?team=85&last=10&timezone=Europe/london` `https://api-football-v1.p.rapidapi.com/v3/fixtures?team=85&season=2019&from=2019-07-01&to=2020-10-31` `https://api-football-v1.p.rapidapi.com/v3/fixtures?league=61&season=2019&from=2019-07-01&to=2020-10-31&timezone=Europe/london` `https://api-football-v1.p.rapidapi.com/v3/fixtures?league=61&season=2019&round=Regular Season - 1`
Try it
Result:
v3_last_xfixtures_that_were_played
For all requests to fixtures you can add the query parameter `timezone` to your request in order to retrieve the list of matches in the time zone of your choice like *“Europe/London“* To know the list of available time zones you have to use the endpoint `timezone` > Some leagues have only final result check our coverage page to know which ones **Available fixtures status** * TBD : Time To Be Defined * NS : Not Started * 1H : First Half, Kick Off * HT : Halftime * 2H : Second Half, 2nd Half Started * ET : Extra Time * P : Penalty In Progress * FT : Match Finished * AET : Match Finished After Extra Time * PEN : Match Finished After Penalty * BT : Break Time (in Extra Time) * SUSP : Match Suspended * INT : Match Interrupted * PST : Match Postponed * CANC : Match Cancelled * ABD : Match Abandoned * AWD : Technical Loss * WO : WalkOver **Update Frequency** : This endpoint is updated every 15 seconds. **Recommended Calls** : 1 call per minute for the leagues, teams, fixtures who have at least one fixture in progress otherwise 1 call per day. > Here are several examples of what can be achieved  **Use Cases** Get fixture from one fixture {id} In this request events, lineups, statistics fixture and players fixture are returned in the response `https://api-football-v1.p.rapidapi.com/v3/fixtures?id=215662` Get fixture from severals fixtures {ids} In this request events, lineups, statistics fixture and players fixture are returned in the response `https://api-football-v1.p.rapidapi.com/v3/fixtures?ids=215662-215663-215664-215665-215666-215667` Get all available fixtures in play In this request events are returned in the response `https://api-football-v1.p.rapidapi.com/v3/fixtures?live=all` Get all available fixtures in play filter by several {league} In this request events are returned in the response `https://api-football-v1.p.rapidapi.com/v3/fixtures?live=39-61-48` Get all available fixtures from one {league} & {season} `https://api-football-v1.p.rapidapi.com/v3/fixtures?league=39&season=2019` Get all available fixtures from one {date} `https://api-football-v1.p.rapidapi.com/v3/fixtures?date=2019-10-22` Get next X available fixtures `https://api-football-v1.p.rapidapi.com/v3/fixtures?next=15` Get last X available fixtures `https://api-football-v1.p.rapidapi.com/v3/fixtures?last=15` It’s possible to make requests by mixing the available parameters `https://api-football-v1.p.rapidapi.com/v3/fixtures?date=2020-01-30&league=61&season=2019` `https://api-football-v1.p.rapidapi.com/v3/fixtures?league=61&next=10` `https://api-football-v1.p.rapidapi.com/v3/fixtures?league=61&last=10&status=ft` `https://api-football-v1.p.rapidapi.com/v3/fixtures?team=85&last=10&timezone=Europe/london` `https://api-football-v1.p.rapidapi.com/v3/fixtures?team=85&season=2019&from=2019-07-01&to=2020-10-31` `https://api-football-v1.p.rapidapi.com/v3/fixtures?league=61&season=2019&from=2019-07-01&to=2020-10-31&timezone=Europe/london` `https://api-football-v1.p.rapidapi.com/v3/fixtures?league=61&season=2019&round=Regular Season - 1`
Try it
Result:
v3_fixtures_from_severals_fixtures_ids
For all requests to fixtures you can add the query parameter `timezone` to your request in order to retrieve the list of matches in the time zone of your choice like *“Europe/London“* To know the list of available time zones you have to use the endpoint `timezone` > Some leagues have only final result check our coverage page to know which ones **Available fixtures status** * TBD : Time To Be Defined * NS : Not Started * 1H : First Half, Kick Off * HT : Halftime * 2H : Second Half, 2nd Half Started * ET : Extra Time * P : Penalty In Progress * FT : Match Finished * AET : Match Finished After Extra Time * PEN : Match Finished After Penalty * BT : Break Time (in Extra Time) * SUSP : Match Suspended * INT : Match Interrupted * PST : Match Postponed * CANC : Match Cancelled * ABD : Match Abandoned * AWD : Technical Loss * WO : WalkOver **Update Frequency** : This endpoint is updated every 15 seconds. **Recommended Calls** : 1 call per minute for the leagues, teams, fixtures who have at least one fixture in progress otherwise 1 call per day. > Here are several examples of what can be achieved  **Use Cases** Get fixture from one fixture {id} In this request events, lineups, statistics fixture and players fixture are returned in the response `https://api-football-v1.p.rapidapi.com/v3/fixtures?id=215662` Get fixture from severals fixtures {ids} In this request events, lineups, statistics fixture and players fixture are returned in the response `https://api-football-v1.p.rapidapi.com/v3/fixtures?ids=215662-215663-215664-215665-215666-215667` Get all available fixtures in play In this request events are returned in the response `https://api-football-v1.p.rapidapi.com/v3/fixtures?live=all` Get all available fixtures in play filter by several {league} In this request events are returned in the response `https://api-football-v1.p.rapidapi.com/v3/fixtures?live=39-61-48` Get all available fixtures from one {league} & {season} `https://api-football-v1.p.rapidapi.com/v3/fixtures?league=39&season=2019` Get all available fixtures from one {date} `https://api-football-v1.p.rapidapi.com/v3/fixtures?date=2019-10-22` Get next X available fixtures `https://api-football-v1.p.rapidapi.com/v3/fixtures?next=15` Get last X available fixtures `https://api-football-v1.p.rapidapi.com/v3/fixtures?last=15` It’s possible to make requests by mixing the available parameters `https://api-football-v1.p.rapidapi.com/v3/fixtures?date=2020-01-30&league=61&season=2019` `https://api-football-v1.p.rapidapi.com/v3/fixtures?league=61&next=10` `https://api-football-v1.p.rapidapi.com/v3/fixtures?league=61&last=10&status=ft` `https://api-football-v1.p.rapidapi.com/v3/fixtures?team=85&last=10&timezone=Europe/london` `https://api-football-v1.p.rapidapi.com/v3/fixtures?team=85&season=2019&from=2019-07-01&to=2020-10-31` `https://api-football-v1.p.rapidapi.com/v3/fixtures?league=61&season=2019&from=2019-07-01&to=2020-10-31&timezone=Europe/london` `https://api-football-v1.p.rapidapi.com/v3/fixtures?league=61&season=2019&round=Regular Season - 1`
Try it
Result:
v3_fixtures_rounds_with_dates
Get the rounds for a league or a cup. The `round` can be used in endpoint fixtures as filters **Update Frequency** : This endpoint is updated every day. **Recommended Calls** : 1 call per day. **Use Cases** Get all available rounds from one {league} & {season} `https://api-football-v1.p.rapidapi.com/v3/rounds?league=39&season=2019` // Get all available rounds from one {league} & {season} With the dates of each round get("https://v3.football.api-sports.io/fixtures/rounds?league=39&season=2019&dates=true"); Get current round from one {league} & {season} `https://api-football-v1.p.rapidapi.com/v3/rounds?league=39&season=2019¤t=true`
Try it
Result:
v3_fixtures_statistics_with_halftime_data
Get the statistics for one fixture with halftime data. **Available statistics** * Shots on Goal * Shots off Goal * Shots insidebox * Shots outsidebox * Total Shots * Blocked Shots * Fouls * Corner Kicks * Offsides * Ball Possession * Yellow Cards * Red Cards * Goalkeeper Saves * Total passes * Passes accurate * Passes % **Update Frequency** : This endpoint is updated every minute. **Recommended Calls** : 1 call every minute for the teams or fixtures who have at least one fixture in progress otherwise 1 call per day. > Here is an example of what can be achieved  **Use Cases** Get all available statistics from one {fixture} `https://v3.football.api-sports.io/fixtures/statistics?fixture=215662` // Get all available statistics from one {fixture} with Fulltime, First & Second Half data get("https://v3.football.api-sports.io/fixtures/statistics?fixture=215662&half=true"); Get all available statistics from one {fixture} & {type} `https://v3.football.api-sports.io/fixtures/statistics?fixture=215662&type=Total Shots` Get all available statistics from one {fixture} & {team} `v3.football.api-sports.io/fixtures/statistics?fixture=215662&team=463`
Try it
Result:
v3_teams_statistics
**Update Frequency** : This endpoint is updated twice a day. **Recommended Calls** : 1 call per day for the teams who have at least one fixture during the day otherwise 1 call per week. > Here is an example of what can be achieved  **Use Cases** Get all statistics for a {team} in a {league} & {season} `https://api-football-v1.p.rapidapi.com/v3/teams/statistics?league=39&team=33&season=2019` Get all statistics for a {team} in a {league} & {season} with a end {date} `https://api-football-v1.p.rapidapi.com/v3/teams/statistics?league=39&team=33&season=2019&date=2019-10-08`
Try it
Result:
v3_teams_informations
Get the list of available teams. The team `id` are **unique** in the API and teams keep it among all the leagues/cups in which they participate. > All the parameters of this endpoint can be used together. **This endpoint requires at least one parameter.** **Update Frequency** : This endpoint is updated several times a week. **Recommended Calls** : 1 call per day. **Use Cases** Get one team from one team {id} `https://api-football-v1.p.rapidapi.com/v3/teams?id=33` Get one team from one team {name} `https://api-football-v1.p.rapidapi.com/v3/teams?name=manchester united` Get all teams from one {league} & {season} `https://api-football-v1.p.rapidapi.com/v3/teams?league=39&season=2019` Get teams from one team {country} `https://api-football-v1.p.rapidapi.com/v3/teams?country=england` Allows you to search for a team in relation to a team {name} or {country} `https://api-football-v1.p.rapidapi.com/v3/teams?search=manches` `https://api-football-v1.p.rapidapi.com/v3/teams?search=England`
Try it
Result:
v3_teams_seasons
Get the list of seasons available for a team. **This endpoint requires at least one parameter.** **Update Frequency** : This endpoint is updated several times a week. **Recommended Calls** : 1 call per day. **Use Cases** Get all seasons available for a team from one team {id} `https://api-football-v1.p.rapidapi.com/v3/teams/seasons?team=33`
Try it
Result:
v3_teams_countries
Get the list of countries available for the `teams` endpoint. **Update Frequency** : This endpoint is updated several times a week. **Recommended Calls** : 1 call per day. **Use Cases** Get all countries available for the teams endpoints `https://api-football-v1.p.rapidapi.com/v3/teams/countries`
Try it
Result:
v3_seasons
Get the list of available seasons. All seasons are only **4-digit keys**, so for a league whose season is `2018-2019` like the English Premier League (EPL), the `2018-2019` season in the API will be `2018`. All `seasons` can be used in other endpoints as filters. > This endpoint does not require any parameters. **Update Frequency** : This endpoint is updated each time a new league is added. **Recommended Calls** : 1 call per day.
Try it
Result:
v3_countries
Get the list of available countries. The `name` and `code` fields can be used in other endpoints as filters. > Examples available in Request samples "Use Cases". All the parameters of this endpoint can be used together. **Update Frequency** : This endpoint is updated each time a new league from a country not covered by the API is added. **Recommended Calls** : 1 call per day. **Use Cases** Get all available countries across all {seasons} and competitions `https://api-football-v1.p.rapidapi.com/v3/countries` Get all available countries from one country {name} `https://api-football-v1.p.rapidapi.com/v3/countries?name=england` Get all available countries from one country {code} `https://api-football-v1.p.rapidapi.com/v3/countries?code=fr` Allows you to search for a countries in relation to a country {name} `https://api-football-v1.p.rapidapi.com/v3/countries?search=engl`
Try it
Result:
v3_leagues
Get the list of available leagues and cups. The league `id` are **unique** in the API and leagues keep it across all `seasons` > Most of the parameters of this endpoint can be used together. **Update Frequency** : This endpoint is updated several times a day. **Recommended Calls** : 1 call per hour. **Use Cases** Allows to retrieve all the seasons available for a league/cup `https://api-football-v1.p.rapidapi.com/v3/leagues?id=39` Get all leagues from one league {name} `https://api-football-v1.p.rapidapi.com/v3/leagues?name=premier league` Get all leagues from one {country} You can find the available {country} by using the endpoint country `https://api-football-v1.p.rapidapi.com/v3/leagues?country=england` Get all leagues from one country {code} (GB, FR, IT etc..) You can find the available country {code} by using the endpoint country `https://api-football-v1.p.rapidapi.com/v3/leagues?code=gb` Get all leagues from one {season} You can find the available {season} by using the endpoint seasons `https://api-football-v1.p.rapidapi.com/v3/leagues?season=2019` Get one league from one league {id} & {season} `https://api-football-v1.p.rapidapi.com/v3/leagues?season=2019&id=39` Get all leagues in which the {team} has played at least one match `https://api-football-v1.p.rapidapi.com/v3/leagues?team=33` Allows you to search for a league in relation to a league {name} or {country} `https://api-football-v1.p.rapidapi.com/v3/leagues?search=premier league` `https://api-football-v1.p.rapidapi.com/v3/leagues?search=England` Get all leagues from one {type} `https://api-football-v1.p.rapidapi.com/v3/leagues?type=league` Get all leagues where the season is in progress or not `https://api-football-v1.p.rapidapi.com/v3/leagues?current=true` Get the last 99 leagues or cups added to the API `https://api-football-v1.p.rapidapi.com/v3/leagues?last=99` It’s possible to make requests by mixing the available parameters `https://api-football-v1.p.rapidapi.com/v3/leagues?season=2019&country=england&type=league` `https://api-football-v1.p.rapidapi.com/v3/leagues?team=85&season=2019` `https://api-football-v1.p.rapidapi.com/v3/leagues?id=61¤t=true&type=league`
Try it
Result:
v3_leagues_by_league_id
Get the list of available leagues and cups. The league `id` are **unique** in the API and leagues keep it across all `seasons` > Most of the parameters of this endpoint can be used together. **Update Frequency** : This endpoint is updated several times a day. **Recommended Calls** : 1 call per hour. **Use Cases** Allows to retrieve all the seasons available for a league/cup `https://api-football-v1.p.rapidapi.com/v3/leagues?id=39` Get all leagues from one league {name} `https://api-football-v1.p.rapidapi.com/v3/leagues?name=premier league` Get all leagues from one {country} You can find the available {country} by using the endpoint country `https://api-football-v1.p.rapidapi.com/v3/leagues?country=england` Get all leagues from one country {code} (GB, FR, IT etc..) You can find the available country {code} by using the endpoint country `https://api-football-v1.p.rapidapi.com/v3/leagues?code=gb` Get all leagues from one {season} You can find the available {season} by using the endpoint seasons `https://api-football-v1.p.rapidapi.com/v3/leagues?season=2019` Get one league from one league {id} & {season} `https://api-football-v1.p.rapidapi.com/v3/leagues?season=2019&id=39` Get all leagues in which the {team} has played at least one match `https://api-football-v1.p.rapidapi.com/v3/leagues?team=33` Allows you to search for a league in relation to a league {name} or {country} `https://api-football-v1.p.rapidapi.com/v3/leagues?search=premier league` `https://api-football-v1.p.rapidapi.com/v3/leagues?search=England` Get all leagues from one {type} `https://api-football-v1.p.rapidapi.com/v3/leagues?type=league` Get all leagues where the season is in progress or not `https://api-football-v1.p.rapidapi.com/v3/leagues?current=true` Get the last 99 leagues or cups added to the API `https://api-football-v1.p.rapidapi.com/v3/leagues?last=99` It’s possible to make requests by mixing the available parameters `https://api-football-v1.p.rapidapi.com/v3/leagues?season=2019&country=england&type=league` `https://api-football-v1.p.rapidapi.com/v3/leagues?team=85&season=2019` `https://api-football-v1.p.rapidapi.com/v3/leagues?id=61¤t=true&type=league`
Try it
Result:
v3_leagues_by_country_name
Get the list of available leagues and cups. The league `id` are **unique** in the API and leagues keep it across all `seasons` > Most of the parameters of this endpoint can be used together. **Update Frequency** : This endpoint is updated several times a day. **Recommended Calls** : 1 call per hour. **Use Cases** Allows to retrieve all the seasons available for a league/cup `https://api-football-v1.p.rapidapi.com/v3/leagues?id=39` Get all leagues from one league {name} `https://api-football-v1.p.rapidapi.com/v3/leagues?name=premier league` Get all leagues from one {country} You can find the available {country} by using the endpoint country `https://api-football-v1.p.rapidapi.com/v3/leagues?country=england` Get all leagues from one country {code} (GB, FR, IT etc..) You can find the available country {code} by using the endpoint country `https://api-football-v1.p.rapidapi.com/v3/leagues?code=gb` Get all leagues from one {season} You can find the available {season} by using the endpoint seasons `https://api-football-v1.p.rapidapi.com/v3/leagues?season=2019` Get one league from one league {id} & {season} `https://api-football-v1.p.rapidapi.com/v3/leagues?season=2019&id=39` Get all leagues in which the {team} has played at least one match `https://api-football-v1.p.rapidapi.com/v3/leagues?team=33` Allows you to search for a league in relation to a league {name} or {country} `https://api-football-v1.p.rapidapi.com/v3/leagues?search=premier league` `https://api-football-v1.p.rapidapi.com/v3/leagues?search=England` Get all leagues from one {type} `https://api-football-v1.p.rapidapi.com/v3/leagues?type=league` Get all leagues where the season is in progress or not `https://api-football-v1.p.rapidapi.com/v3/leagues?current=true` Get the last 99 leagues or cups added to the API `https://api-football-v1.p.rapidapi.com/v3/leagues?last=99` It’s possible to make requests by mixing the available parameters `https://api-football-v1.p.rapidapi.com/v3/leagues?season=2019&country=england&type=league` `https://api-football-v1.p.rapidapi.com/v3/leagues?team=85&season=2019` `https://api-football-v1.p.rapidapi.com/v3/leagues?id=61¤t=true&type=league`
Try it
Result:
v3_leagues_by_country_code
Get the list of available leagues and cups. The league `id` are **unique** in the API and leagues keep it across all `seasons` > Most of the parameters of this endpoint can be used together. **Update Frequency** : This endpoint is updated several times a day. **Recommended Calls** : 1 call per hour. **Use Cases** Allows to retrieve all the seasons available for a league/cup `https://api-football-v1.p.rapidapi.com/v3/leagues?id=39` Get all leagues from one league {name} `https://api-football-v1.p.rapidapi.com/v3/leagues?name=premier league` Get all leagues from one {country} You can find the available {country} by using the endpoint country `https://api-football-v1.p.rapidapi.com/v3/leagues?country=england` Get all leagues from one country {code} (GB, FR, IT etc..) You can find the available country {code} by using the endpoint country `https://api-football-v1.p.rapidapi.com/v3/leagues?code=gb` Get all leagues from one {season} You can find the available {season} by using the endpoint seasons `https://api-football-v1.p.rapidapi.com/v3/leagues?season=2019` Get one league from one league {id} & {season} `https://api-football-v1.p.rapidapi.com/v3/leagues?season=2019&id=39` Get all leagues in which the {team} has played at least one match `https://api-football-v1.p.rapidapi.com/v3/leagues?team=33` Allows you to search for a league in relation to a league {name} or {country} `https://api-football-v1.p.rapidapi.com/v3/leagues?search=premier league` `https://api-football-v1.p.rapidapi.com/v3/leagues?search=England` Get all leagues from one {type} `https://api-football-v1.p.rapidapi.com/v3/leagues?type=league` Get all leagues where the season is in progress or not `https://api-football-v1.p.rapidapi.com/v3/leagues?current=true` Get the last 99 leagues or cups added to the API `https://api-football-v1.p.rapidapi.com/v3/leagues?last=99` It’s possible to make requests by mixing the available parameters `https://api-football-v1.p.rapidapi.com/v3/leagues?season=2019&country=england&type=league` `https://api-football-v1.p.rapidapi.com/v3/leagues?team=85&season=2019` `https://api-football-v1.p.rapidapi.com/v3/leagues?id=61¤t=true&type=league`
Try it
Result:
v3_leagues_by_season
Get the list of available leagues and cups. The league `id` are **unique** in the API and leagues keep it across all `seasons` > Most of the parameters of this endpoint can be used together. **Update Frequency** : This endpoint is updated several times a day. **Recommended Calls** : 1 call per hour. **Use Cases** Allows to retrieve all the seasons available for a league/cup `https://api-football-v1.p.rapidapi.com/v3/leagues?id=39` Get all leagues from one league {name} `https://api-football-v1.p.rapidapi.com/v3/leagues?name=premier league` Get all leagues from one {country} You can find the available {country} by using the endpoint country `https://api-football-v1.p.rapidapi.com/v3/leagues?country=england` Get all leagues from one country {code} (GB, FR, IT etc..) You can find the available country {code} by using the endpoint country `https://api-football-v1.p.rapidapi.com/v3/leagues?code=gb` Get all leagues from one {season} You can find the available {season} by using the endpoint seasons `https://api-football-v1.p.rapidapi.com/v3/leagues?season=2019` Get one league from one league {id} & {season} `https://api-football-v1.p.rapidapi.com/v3/leagues?season=2019&id=39` Get all leagues in which the {team} has played at least one match `https://api-football-v1.p.rapidapi.com/v3/leagues?team=33` Allows you to search for a league in relation to a league {name} or {country} `https://api-football-v1.p.rapidapi.com/v3/leagues?search=premier league` `https://api-football-v1.p.rapidapi.com/v3/leagues?search=England` Get all leagues from one {type} `https://api-football-v1.p.rapidapi.com/v3/leagues?type=league` Get all leagues where the season is in progress or not `https://api-football-v1.p.rapidapi.com/v3/leagues?current=true` Get the last 99 leagues or cups added to the API `https://api-football-v1.p.rapidapi.com/v3/leagues?last=99` It’s possible to make requests by mixing the available parameters `https://api-football-v1.p.rapidapi.com/v3/leagues?season=2019&country=england&type=league` `https://api-football-v1.p.rapidapi.com/v3/leagues?team=85&season=2019` `https://api-football-v1.p.rapidapi.com/v3/leagues?id=61¤t=true&type=league`
Try it
Result:
v3_leagues_by_team_id
Get the list of available leagues and cups. The league `id` are **unique** in the API and leagues keep it across all `seasons` > Most of the parameters of this endpoint can be used together. **Update Frequency** : This endpoint is updated several times a day. **Recommended Calls** : 1 call per hour. **Use Cases** Allows to retrieve all the seasons available for a league/cup `https://api-football-v1.p.rapidapi.com/v3/leagues?id=39` Get all leagues from one league {name} `https://api-football-v1.p.rapidapi.com/v3/leagues?name=premier league` Get all leagues from one {country} You can find the available {country} by using the endpoint country `https://api-football-v1.p.rapidapi.com/v3/leagues?country=england` Get all leagues from one country {code} (GB, FR, IT etc..) You can find the available country {code} by using the endpoint country `https://api-football-v1.p.rapidapi.com/v3/leagues?code=gb` Get all leagues from one {season} You can find the available {season} by using the endpoint seasons `https://api-football-v1.p.rapidapi.com/v3/leagues?season=2019` Get one league from one league {id} & {season} `https://api-football-v1.p.rapidapi.com/v3/leagues?season=2019&id=39` Get all leagues in which the {team} has played at least one match `https://api-football-v1.p.rapidapi.com/v3/leagues?team=33` Allows you to search for a league in relation to a league {name} or {country} `https://api-football-v1.p.rapidapi.com/v3/leagues?search=premier league` `https://api-football-v1.p.rapidapi.com/v3/leagues?search=England` Get all leagues from one {type} `https://api-football-v1.p.rapidapi.com/v3/leagues?type=league` Get all leagues where the season is in progress or not `https://api-football-v1.p.rapidapi.com/v3/leagues?current=true` Get the last 99 leagues or cups added to the API `https://api-football-v1.p.rapidapi.com/v3/leagues?last=99` It’s possible to make requests by mixing the available parameters `https://api-football-v1.p.rapidapi.com/v3/leagues?season=2019&country=england&type=league` `https://api-football-v1.p.rapidapi.com/v3/leagues?team=85&season=2019` `https://api-football-v1.p.rapidapi.com/v3/leagues?id=61¤t=true&type=league`
Try it
Result:
v3_leagues_by_type
Get the list of available leagues and cups. The league `id` are **unique** in the API and leagues keep it across all `seasons` > Most of the parameters of this endpoint can be used together. **Update Frequency** : This endpoint is updated several times a day. **Recommended Calls** : 1 call per hour. **Use Cases** Allows to retrieve all the seasons available for a league/cup `https://api-football-v1.p.rapidapi.com/v3/leagues?id=39` Get all leagues from one league {name} `https://api-football-v1.p.rapidapi.com/v3/leagues?name=premier league` Get all leagues from one {country} You can find the available {country} by using the endpoint country `https://api-football-v1.p.rapidapi.com/v3/leagues?country=england` Get all leagues from one country {code} (GB, FR, IT etc..) You can find the available country {code} by using the endpoint country `https://api-football-v1.p.rapidapi.com/v3/leagues?code=gb` Get all leagues from one {season} You can find the available {season} by using the endpoint seasons `https://api-football-v1.p.rapidapi.com/v3/leagues?season=2019` Get one league from one league {id} & {season} `https://api-football-v1.p.rapidapi.com/v3/leagues?season=2019&id=39` Get all leagues in which the {team} has played at least one match `https://api-football-v1.p.rapidapi.com/v3/leagues?team=33` Allows you to search for a league in relation to a league {name} or {country} `https://api-football-v1.p.rapidapi.com/v3/leagues?search=premier league` `https://api-football-v1.p.rapidapi.com/v3/leagues?search=England` Get all leagues from one {type} `https://api-football-v1.p.rapidapi.com/v3/leagues?type=league` Get all leagues where the season is in progress or not `https://api-football-v1.p.rapidapi.com/v3/leagues?current=true` Get the last 99 leagues or cups added to the API `https://api-football-v1.p.rapidapi.com/v3/leagues?last=99` It’s possible to make requests by mixing the available parameters `https://api-football-v1.p.rapidapi.com/v3/leagues?season=2019&country=england&type=league` `https://api-football-v1.p.rapidapi.com/v3/leagues?team=85&season=2019` `https://api-football-v1.p.rapidapi.com/v3/leagues?id=61¤t=true&type=league`
Try it
Result:
v3_leagues_whose_season_is_running
Get the list of available leagues and cups. The league `id` are **unique** in the API and leagues keep it across all `seasons` > Most of the parameters of this endpoint can be used together. **Update Frequency** : This endpoint is updated several times a day. **Recommended Calls** : 1 call per hour. **Use Cases** Allows to retrieve all the seasons available for a league/cup `https://api-football-v1.p.rapidapi.com/v3/leagues?id=39` Get all leagues from one league {name} `https://api-football-v1.p.rapidapi.com/v3/leagues?name=premier league` Get all leagues from one {country} You can find the available {country} by using the endpoint country `https://api-football-v1.p.rapidapi.com/v3/leagues?country=england` Get all leagues from one country {code} (GB, FR, IT etc..) You can find the available country {code} by using the endpoint country `https://api-football-v1.p.rapidapi.com/v3/leagues?code=gb` Get all leagues from one {season} You can find the available {season} by using the endpoint seasons `https://api-football-v1.p.rapidapi.com/v3/leagues?season=2019` Get one league from one league {id} & {season} `https://api-football-v1.p.rapidapi.com/v3/leagues?season=2019&id=39` Get all leagues in which the {team} has played at least one match `https://api-football-v1.p.rapidapi.com/v3/leagues?team=33` Allows you to search for a league in relation to a league {name} or {country} `https://api-football-v1.p.rapidapi.com/v3/leagues?search=premier league` `https://api-football-v1.p.rapidapi.com/v3/leagues?search=England` Get all leagues from one {type} `https://api-football-v1.p.rapidapi.com/v3/leagues?type=league` Get all leagues where the season is in progress or not `https://api-football-v1.p.rapidapi.com/v3/leagues?current=true` Get the last 99 leagues or cups added to the API `https://api-football-v1.p.rapidapi.com/v3/leagues?last=99` It’s possible to make requests by mixing the available parameters `https://api-football-v1.p.rapidapi.com/v3/leagues?season=2019&country=england&type=league` `https://api-football-v1.p.rapidapi.com/v3/leagues?team=85&season=2019` `https://api-football-v1.p.rapidapi.com/v3/leagues?id=61¤t=true&type=league`
Try it
Result:
v3_bets
Get all available bets. All bets `id` can be used in endpoint odds as filters. **Update Frequency** : This endpoint is updated several times a week. **Recommended Calls** : 1 call per day. **Use Cases** Get all available bets `https://api-football-v1.p.rapidapi.com/v3/odds/bets` Get bet from one {id} `https://api-football-v1.p.rapidapi.com/v3/odds/bets?id=1` Allows you to search for a bet in relation to a bets {name} `https://api-football-v1.p.rapidapi.com/v3/odds/bets?search=winner`
Try it
Result:
v3_bookmakers
Get all available bookmakers. All bookmakers `id` can be used in endpoint odds as filters. **Update Frequency** : This endpoint is updated several times a week. **Recommended Calls** : 1 call per day. **Use Cases** Get all available bookmakers `https://api-football-v1.p.rapidapi.com/v3/odds/bookmakers` Get bookmaker from one {id} `https://api-football-v1.p.rapidapi.com/v3/odds/bookmakers?id=1` Allows you to search for a bookmaker in relation to a bookmakers {name} `https://api-football-v1.p.rapidapi.com/v3/odds/bookmakers?search=Betfair`
Try it
Result:
v3_odds_mapping
Get the list of available odds. All fixtures, leagues `id` and `date` can be used in endpoint odds as filters. This endpoint uses a **pagination system**, you can navigate between the different pages thanks to the `page` parameter. > **Pagination** : 100 results per page. **Update Frequency** : This endpoint is updated every day. **Recommended Calls** : 1 call per day.
Try it
Result:
v3_odds_by_date
Get odds from fixtures, leagues or date. This endpoint uses a **pagination system**, you can navigate between the different pages with to the `page` parameter. > **Pagination** : 10 results per page. We provide pre-match odds between 1 and 14 days before the fixture. We keep a 7-days history *(The availability of odds may vary according to the leagues, seasons, fixtures and bookmakers)* **Update Frequency** : This endpoint is updated every 3 hours. **Recommended Calls** : 1 call every 3 hours. **Use Cases** Get all available odds from one {fixture} `https://api-football-v1.p.rapidapi.com/v3/odds?fixture=164327` Get all available odds from one {league} & {season} `https://api-football-v1.p.rapidapi.com/v3/odds?league=39&season=2019` Get all available odds from one {date} `https://api-football-v1.p.rapidapi.com/v3/odds?date=2020-05-15` It’s possible to make requests by mixing the available parameters `https://api-football-v1.p.rapidapi.com/v3/odds?bookmaker=1&bet=4&league=39&season=2019` `https://api-football-v1.p.rapidapi.com/v3/odds?bet=4&fixture=164327` `https://api-football-v1.p.rapidapi.com/v3/odds?bookmaker=1&league=39&season=2019` `https://api-football-v1.p.rapidapi.com/v3/odds?date=2020-05-15&page=2&bet=4`
Try it
Result:
v3_odds_filtered_by_bet_id
Get odds from fixtures, leagues or date. This endpoint uses a **pagination system**, you can navigate between the different pages with to the `page` parameter. > **Pagination** : 10 results per page. We provide pre-match odds between 1 and 14 days before the fixture. We keep a 7-days history *(The availability of odds may vary according to the leagues, seasons, fixtures and bookmakers)* **Update Frequency** : This endpoint is updated every 3 hours. **Recommended Calls** : 1 call every 3 hours. **Use Cases** Get all available odds from one {fixture} `https://api-football-v1.p.rapidapi.com/v3/odds?fixture=164327` Get all available odds from one {league} & {season} `https://api-football-v1.p.rapidapi.com/v3/odds?league=39&season=2019` Get all available odds from one {date} `https://api-football-v1.p.rapidapi.com/v3/odds?date=2020-05-15` It’s possible to make requests by mixing the available parameters `https://api-football-v1.p.rapidapi.com/v3/odds?bookmaker=1&bet=4&league=39&season=2019` `https://api-football-v1.p.rapidapi.com/v3/odds?bet=4&fixture=164327` `https://api-football-v1.p.rapidapi.com/v3/odds?bookmaker=1&league=39&season=2019` `https://api-football-v1.p.rapidapi.com/v3/odds?date=2020-05-15&page=2&bet=4`
Try it
Result:
v3_odds_filtered_by_bookmaker_id
Get odds from fixtures, leagues or date. This endpoint uses a **pagination system**, you can navigate between the different pages with to the `page` parameter. > **Pagination** : 10 results per page. We provide pre-match odds between 1 and 14 days before the fixture. We keep a 7-days history *(The availability of odds may vary according to the leagues, seasons, fixtures and bookmakers)* **Update Frequency** : This endpoint is updated every 3 hours. **Recommended Calls** : 1 call every 3 hours. **Use Cases** Get all available odds from one {fixture} `https://api-football-v1.p.rapidapi.com/v3/odds?fixture=164327` Get all available odds from one {league} & {season} `https://api-football-v1.p.rapidapi.com/v3/odds?league=39&season=2019` Get all available odds from one {date} `https://api-football-v1.p.rapidapi.com/v3/odds?date=2020-05-15` It’s possible to make requests by mixing the available parameters `https://api-football-v1.p.rapidapi.com/v3/odds?bookmaker=1&bet=4&league=39&season=2019` `https://api-football-v1.p.rapidapi.com/v3/odds?bet=4&fixture=164327` `https://api-football-v1.p.rapidapi.com/v3/odds?bookmaker=1&league=39&season=2019` `https://api-football-v1.p.rapidapi.com/v3/odds?date=2020-05-15&page=2&bet=4`
Try it
Result:
v3_odds_by_league_id
Get odds from fixtures, leagues or date. This endpoint uses a **pagination system**, you can navigate between the different pages with to the `page` parameter. > **Pagination** : 10 results per page. We provide pre-match odds between 1 and 14 days before the fixture. We keep a 7-days history *(The availability of odds may vary according to the leagues, seasons, fixtures and bookmakers)* **Update Frequency** : This endpoint is updated every 3 hours. **Recommended Calls** : 1 call every 3 hours. **Use Cases** Get all available odds from one {fixture} `https://api-football-v1.p.rapidapi.com/v3/odds?fixture=164327` Get all available odds from one {league} & {season} `https://api-football-v1.p.rapidapi.com/v3/odds?league=39&season=2019` Get all available odds from one {date} `https://api-football-v1.p.rapidapi.com/v3/odds?date=2020-05-15` It’s possible to make requests by mixing the available parameters `https://api-football-v1.p.rapidapi.com/v3/odds?bookmaker=1&bet=4&league=39&season=2019` `https://api-football-v1.p.rapidapi.com/v3/odds?bet=4&fixture=164327` `https://api-football-v1.p.rapidapi.com/v3/odds?bookmaker=1&league=39&season=2019` `https://api-football-v1.p.rapidapi.com/v3/odds?date=2020-05-15&page=2&bet=4`
Try it
Result:
v3_odds_by_fixture_id
Get odds from fixtures, leagues or date. This endpoint uses a **pagination system**, you can navigate between the different pages with to the `page` parameter. > **Pagination** : 10 results per page. We provide pre-match odds between 1 and 14 days before the fixture. We keep a 7-days history *(The availability of odds may vary according to the leagues, seasons, fixtures and bookmakers)* **Update Frequency** : This endpoint is updated every 3 hours. **Recommended Calls** : 1 call every 3 hours. **Use Cases** Get all available odds from one {fixture} `https://api-football-v1.p.rapidapi.com/v3/odds?fixture=164327` Get all available odds from one {league} & {season} `https://api-football-v1.p.rapidapi.com/v3/odds?league=39&season=2019` Get all available odds from one {date} `https://api-football-v1.p.rapidapi.com/v3/odds?date=2020-05-15` It’s possible to make requests by mixing the available parameters `https://api-football-v1.p.rapidapi.com/v3/odds?bookmaker=1&bet=4&league=39&season=2019` `https://api-football-v1.p.rapidapi.com/v3/odds?bet=4&fixture=164327` `https://api-football-v1.p.rapidapi.com/v3/odds?bookmaker=1&league=39&season=2019` `https://api-football-v1.p.rapidapi.com/v3/odds?date=2020-05-15&page=2&bet=4`
Try it
Result:
v3_fixtures_events
Get the events from a fixture. **Available events** * Goal : Normal Goal, Own Goal, Penalty, Missed Penalty * Card : Yellow Card, Second Yellow card, Red card * Subst : Substitution [1, 2, 3...] * Var : Goal cancelled, Penalty confirmed **Update Frequency** : This endpoint is updated every 15 seconds. **Recommended Calls** : 1 call per minute for the fixtures in progress otherwise 1 call per day. You can also retrieve all the events of the fixtures in progress thanks to the endpoint `fixtures?live=all` > Here is an example of what can be achieved  **Use Cases** Get all available events from one {fixture} `https://api-football-v1.p.rapidapi.com/v3/fixtures/events?fixture=215662` Get all available events from one {fixture} & {team} `https://api-football-v1.p.rapidapi.com/v3/fixtures/events?fixture=215662&team=463` Get all available events from one {fixture} & {player} `https://api-football-v1.p.rapidapi.com/v3/fixtures/events?fixture=215662&player=35845` Get all available events from one {fixture} & {type} `https://api-football-v1.p.rapidapi.com/v3/fixtures/events?fixture=215662&type=card` It’s possible to make requests by mixing the available parameters `https://api-football-v1.p.rapidapi.com/v3/fixtures/events?fixture=215662&player=35845&type=card` `https://api-football-v1.p.rapidapi.com/v3/fixtures/events?fixture=215662&team=463&type=goal&player=35845`
Try it
Result:
v3_fixtures_events_filtered_by_player_id
Get the events from a fixture. **Available events** * Goal : Normal Goal, Own Goal, Penalty, Missed Penalty * Card : Yellow Card, Second Yellow card, Red card * Subst : Substitution [1, 2, 3...] * Var : Goal cancelled, Penalty confirmed **Update Frequency** : This endpoint is updated every 15 seconds. **Recommended Calls** : 1 call per minute for the fixtures in progress otherwise 1 call per day. You can also retrieve all the events of the fixtures in progress thanks to the endpoint `fixtures?live=all` > Here is an example of what can be achieved  **Use Cases** Get all available events from one {fixture} `https://api-football-v1.p.rapidapi.com/v3/fixtures/events?fixture=215662` Get all available events from one {fixture} & {team} `https://api-football-v1.p.rapidapi.com/v3/fixtures/events?fixture=215662&team=463` Get all available events from one {fixture} & {player} `https://api-football-v1.p.rapidapi.com/v3/fixtures/events?fixture=215662&player=35845` Get all available events from one {fixture} & {type} `https://api-football-v1.p.rapidapi.com/v3/fixtures/events?fixture=215662&type=card` It’s possible to make requests by mixing the available parameters `https://api-football-v1.p.rapidapi.com/v3/fixtures/events?fixture=215662&player=35845&type=card` `https://api-football-v1.p.rapidapi.com/v3/fixtures/events?fixture=215662&team=463&type=goal&player=35845`
Try it
Result:
v3_fixtures_events_filtered_by_team_id
Get the events from a fixture. **Available events** * Goal : Normal Goal, Own Goal, Penalty, Missed Penalty * Card : Yellow Card, Second Yellow card, Red card * Subst : Substitution [1, 2, 3...] * Var : Goal cancelled, Penalty confirmed **Update Frequency** : This endpoint is updated every 15 seconds. **Recommended Calls** : 1 call per minute for the fixtures in progress otherwise 1 call per day. You can also retrieve all the events of the fixtures in progress thanks to the endpoint `fixtures?live=all` > Here is an example of what can be achieved  **Use Cases** Get all available events from one {fixture} `https://api-football-v1.p.rapidapi.com/v3/fixtures/events?fixture=215662` Get all available events from one {fixture} & {team} `https://api-football-v1.p.rapidapi.com/v3/fixtures/events?fixture=215662&team=463` Get all available events from one {fixture} & {player} `https://api-football-v1.p.rapidapi.com/v3/fixtures/events?fixture=215662&player=35845` Get all available events from one {fixture} & {type} `https://api-football-v1.p.rapidapi.com/v3/fixtures/events?fixture=215662&type=card` It’s possible to make requests by mixing the available parameters `https://api-football-v1.p.rapidapi.com/v3/fixtures/events?fixture=215662&player=35845&type=card` `https://api-football-v1.p.rapidapi.com/v3/fixtures/events?fixture=215662&team=463&type=goal&player=35845`
Try it
Result:
v3_standings_by_league_id
Get the standings for a league or a team. Return a table of one or more rankings according to the league / cup. Some competitions have several rankings in a year, group phase, opening ranking, closing ranking etc… > Most of the parameters of this endpoint can be used together. **Update Frequency** : This endpoint is updated every hour. **Recommended Calls** : 1 call per hour for the leagues or teams who have at least one fixture in progress otherwise 1 call per day. **Use Cases** Get all Standings from one {league} & {season} `https://api-football-v1.p.rapidapi.com/v3/standings?league=39&season=2019` Get all Standings from one {league} & {season} & {team} `https://api-football-v1.p.rapidapi.com/v3/standings?league=39&team=33&season=2019` Get all Standings from one {team} & {season} `https://api-football-v1.p.rapidapi.com/v3/standings?team=33&season=2019`
Try it
Result:
v3_standings_by_team_id
Get the standings for a league or a team. Return a table of one or more rankings according to the league / cup. Some competitions have several rankings in a year, group phase, opening ranking, closing ranking etc… > Most of the parameters of this endpoint can be used together. **Update Frequency** : This endpoint is updated every hour. **Recommended Calls** : 1 call per hour for the leagues or teams who have at least one fixture in progress otherwise 1 call per day. **Use Cases** Get all Standings from one {league} & {season} `https://api-football-v1.p.rapidapi.com/v3/standings?league=39&season=2019` Get all Standings from one {league} & {season} & {team} `https://api-football-v1.p.rapidapi.com/v3/standings?league=39&team=33&season=2019` Get all Standings from one {team} & {season} `https://api-football-v1.p.rapidapi.com/v3/standings?team=33&season=2019`
Try it
Result:
v3_fixtures_statistics
Get the statistics for one fixture. **Available statistics** * Shots on Goal * Shots off Goal * Shots insidebox * Shots outsidebox * Total Shots * Blocked Shots * Fouls * Corner Kicks * Offsides * Ball Possession * Yellow Cards * Red Cards * Goalkeeper Saves * Total passes * Passes accurate * Passes % **Update Frequency** : This endpoint is updated every minute. **Recommended Calls** : 1 call every minute for the teams or fixtures who have at least one fixture in progress otherwise 1 call per day. > Here is an example of what can be achieved  **Use Cases** Get all available statistics from one {fixture} `https://v3.football.api-sports.io/fixtures/statistics?fixture=215662` Get all available statistics from one {fixture} & {type} `https://v3.football.api-sports.io/fixtures/statistics?fixture=215662&type=Total Shots` Get all available statistics from one {fixture} & {team} `v3.football.api-sports.io/fixtures/statistics?fixture=215662&team=463`
Try it
Result:
v3_fixtures_statistics_filtered_by_type
Get the statistics for one fixture. **Available statistics** * Shots on Goal * Shots off Goal * Shots insidebox * Shots outsidebox * Total Shots * Blocked Shots * Fouls * Corner Kicks * Offsides * Ball Possession * Yellow Cards * Red Cards * Goalkeeper Saves * Total passes * Passes accurate * Passes % **Update Frequency** : This endpoint is updated every minute. **Recommended Calls** : 1 call every minute for the teams or fixtures who have at least one fixture in progress otherwise 1 call per day. > Here is an example of what can be achieved  **Use Cases** Get all available statistics from one {fixture} `https://v3.football.api-sports.io/fixtures/statistics?fixture=215662` Get all available statistics from one {fixture} & {type} `https://v3.football.api-sports.io/fixtures/statistics?fixture=215662&type=Total Shots` Get all available statistics from one {fixture} & {team} `v3.football.api-sports.io/fixtures/statistics?fixture=215662&team=463`
Try it
Result:
v3_fixtures_statistics_filtered_by_team_id
Get the statistics for one fixture. **Available statistics** * Shots on Goal * Shots off Goal * Shots insidebox * Shots outsidebox * Total Shots * Blocked Shots * Fouls * Corner Kicks * Offsides * Ball Possession * Yellow Cards * Red Cards * Goalkeeper Saves * Total passes * Passes accurate * Passes % **Update Frequency** : This endpoint is updated every minute. **Recommended Calls** : 1 call every minute for the teams or fixtures who have at least one fixture in progress otherwise 1 call per day. > Here is an example of what can be achieved  **Use Cases** Get all available statistics from one {fixture} `https://v3.football.api-sports.io/fixtures/statistics?fixture=215662` Get all available statistics from one {fixture} & {type} `https://v3.football.api-sports.io/fixtures/statistics?fixture=215662&type=Total Shots` Get all available statistics from one {fixture} & {team} `v3.football.api-sports.io/fixtures/statistics?fixture=215662&team=463`
Try it
Result:
v3_players_statistics_by_player_id
Get players statistics. The players `id` are unique in the API and players keep it among all the teams they have been in The statistics are calculated according to the team `id`, league `id` and `season`. You can find the available `seasons` by using the endpoint players seasons. This endpoint uses a **pagination system**, you can navigate between the different pages thanks to the `page` parameter. > **Pagination** : 20 results per page. **Update Frequency** : This endpoint is updated several times a week. **Recommended Calls** : 1 call per day. **Use Cases** Get all players statistics from one player {id} & {season} `https://api-football-v1.p.rapidapi.com/v3/players?id=19088&season=2018` Get all players statistics from one {team} & {season} `https://api-football-v1.p.rapidapi.com/v3/players?season=2018&team=33` `https://api-football-v1.p.rapidapi.com/v3/players?season=2018&team=33&page=2` Get all players statistics from one {league} & {season} `https://api-football-v1.p.rapidapi.com/v3/players?season=2018&league=61` `https://api-football-v1.p.rapidapi.com/v3/players?season=2018&league=61&page=4` Get all players statistics from one {league}, {team} & {season} `https://api-football-v1.p.rapidapi.com/v3/players?season=2018&league=61&team=33` `https://api-football-v1.p.rapidapi.com/v3/players?season=2018&league=61&team=33&page=5` Allows you to search for a player in relation to a player {name} `https://api-football-v1.p.rapidapi.com/v3/players?team=85&search=cavani` `https://api-football-v1.p.rapidapi.com/v3/players?league=61&search=cavani` `https://api-football-v1.p.rapidapi.com/v3/players?team=85&search=cavani&season=2018`
Try it
Result:
v3_players_seasons
Get all available seasons for players statistics. **Update Frequency** : This endpoint is updated every day. **Recommended Calls** : 1 call per day.
Try it
Result:
v3_players_statistics_by_fixture_id
Get the players statistics from one fixture. **Update Frequency** : This endpoint is updated every minute. **Recommended Calls** : 1 call every minute for the fixtures in progress otherwise 1 call per day. **Use Cases** Get all available players statistics from one {fixture} `https://api-football-v1.p.rapidapi.com/v3/fixtures/players?fixture=169080` Get all available players statistics from one {fixture} & {team} `https://api-football-v1.p.rapidapi.com/v3/fixtures/players?fixture=169080&team=2284`
Try it
Result:
v3_players_statistics_by_league_id
Get players statistics. The players `id` are unique in the API and players keep it among all the teams they have been in The statistics are calculated according to the team `id`, league `id` and `season`. You can find the available `seasons` by using the endpoint players seasons. This endpoint uses a **pagination system**, you can navigate between the different pages thanks to the `page` parameter. > **Pagination** : 20 results per page. **Update Frequency** : This endpoint is updated several times a week. **Recommended Calls** : 1 call per day. **Use Cases** Get all players statistics from one player {id} & {season} `https://api-football-v1.p.rapidapi.com/v3/players?id=19088&season=2018` Get all players statistics from one {team} & {season} `https://api-football-v1.p.rapidapi.com/v3/players?season=2018&team=33` `https://api-football-v1.p.rapidapi.com/v3/players?season=2018&team=33&page=2` Get all players statistics from one {league} & {season} `https://api-football-v1.p.rapidapi.com/v3/players?season=2018&league=61` `https://api-football-v1.p.rapidapi.com/v3/players?season=2018&league=61&page=4` Get all players statistics from one {league}, {team} & {season} `https://api-football-v1.p.rapidapi.com/v3/players?season=2018&league=61&team=33` `https://api-football-v1.p.rapidapi.com/v3/players?season=2018&league=61&team=33&page=5` Allows you to search for a player in relation to a player {name} `https://api-football-v1.p.rapidapi.com/v3/players?team=85&search=cavani` `https://api-football-v1.p.rapidapi.com/v3/players?league=61&search=cavani` `https://api-football-v1.p.rapidapi.com/v3/players?team=85&search=cavani&season=2018`
Try it
Result:
v3_players_statistics_by_team_id
Get players statistics. The players `id` are unique in the API and players keep it among all the teams they have been in The statistics are calculated according to the team `id`, league `id` and `season`. You can find the available `seasons` by using the endpoint players seasons. This endpoint uses a **pagination system**, you can navigate between the different pages thanks to the `page` parameter. > **Pagination** : 20 results per page. **Update Frequency** : This endpoint is updated several times a week. **Recommended Calls** : 1 call per day. **Use Cases** Get all players statistics from one player {id} & {season} `https://api-football-v1.p.rapidapi.com/v3/players?id=19088&season=2018` Get all players statistics from one {team} & {season} `https://api-football-v1.p.rapidapi.com/v3/players?season=2018&team=33` `https://api-football-v1.p.rapidapi.com/v3/players?season=2018&team=33&page=2` Get all players statistics from one {league} & {season} `https://api-football-v1.p.rapidapi.com/v3/players?season=2018&league=61` `https://api-football-v1.p.rapidapi.com/v3/players?season=2018&league=61&page=4` Get all players statistics from one {league}, {team} & {season} `https://api-football-v1.p.rapidapi.com/v3/players?season=2018&league=61&team=33` `https://api-football-v1.p.rapidapi.com/v3/players?season=2018&league=61&team=33&page=5` Allows you to search for a player in relation to a player {name} `https://api-football-v1.p.rapidapi.com/v3/players?team=85&search=cavani` `https://api-football-v1.p.rapidapi.com/v3/players?league=61&search=cavani` `https://api-football-v1.p.rapidapi.com/v3/players?team=85&search=cavani&season=2018`
Try it
Result:
v3_players_seasons_by_player_id
Get all available seasons for players statistics filtered by a player {id}. **Update Frequency** : This endpoint is updated every day. **Recommended Calls** : 1 call per day. **Use Cases** Get all seasons available for a player {id} `https://api-football-v1.p.rapidapi.com/v3/players/seasons?player=276`
Try it
Result:
v3_players_squads
Return the current squad of a team when the `team` parameter is used. When the `player` parameter is used the endpoint returns the set of teams associated with the player. > The response format is the same regardless of the parameter sent. **This endpoint requires at least one parameter.** **Update Frequency** : This endpoint is updated several times a week. **Recommended Calls** : 1 call per week. **Use Cases** Get all players from one {team} `https://api-football-v1.p.rapidapi.com/v3/players/squads?team=33` Get all teams from one {player} `https://api-football-v1.p.rapidapi.com/v3/players/squads?player=276`
Try it
Result:
v3_players_profiles
Returns the list of all available players. It is possible to call this endpoint without parameters, but you will need to use the **pagination** to get all available players. To get the photo of a player you have to call the following url: `https://media.api-sports.io/football/players/{player_id}.png` This endpoint uses a **pagination system**, you can navigate between the different pages with to the `page` parameter. > **Pagination** : 250 results per page. **Update Frequency** : This endpoint is updated several times a week. **Recommended Calls** : 1 call per week. // Get data from one {player} get("https://v3.football.api-sports.io/players/profiles?player=276"); // Allows you to search for a player in relation to a player {lastname} get("https://v3.football.api-sports.io/players/profiles?search=ney"); // Get all available Players (limited to 250 results, use the pagination for next ones) get("https://v3.football.api-sports.io/players/profiles"); get("https://v3.football.api-sports.io/players/profiles?page=2"); get("https://v3.football.api-sports.io/players/profiles?page=3");
Try it
Result:
v3_players_teams
Returns the list of teams and seasons in which the player played during his career. **This endpoint requires at least one parameter.** **Update Frequency** : This endpoint is updated several times a week. **Recommended Calls** : 1 call per week.
Try it
Result:
v3_fixtures_lineups
Get the lineups for a fixture. **Available datas** * Formation * Coach * Start XI * Substitutes > Lineups are available between 20 and 40 minutes before the fixture. **Players' positions on the grid** **X** = row and **Y** = column (X:Y) Line 1 **X** being the one of the goal and then for each line this number is incremented. The column **Y** will go from left to right, and incremented for each player of the line. `As a new feature, some irregularities may occur, do not hesitate to report them on our public Roadmap` **Update Frequency** : This endpoint is updated every 15 minutes. **Recommended Calls** : 1 call every 15 minutes for the fixtures in progress otherwise 1 call per day. > Here are several examples of what can be done   **Use Cases** Get all available lineups from one {fixture} `https://api-football-v1.p.rapidapi.com/v3/fixtures/lineups?fixture=215662` Get all available lineups from one {fixture} & {team} `https://api-football-v1.p.rapidapi.com/v3/fixtures/lineups?fixture=215662&team=463` Get all available lineups from one {fixture} & {player} `https://api-football-v1.p.rapidapi.com/v3/fixtures/lineups?fixture=215662&player=35845` Get all available lineups from one {fixture} & {type} `https://api-football-v1.p.rapidapi.com/v3/fixtures/lineups?fixture=215662&type=startXI` It’s possible to make requests by mixing the available parameters `https://api-football-v1.p.rapidapi.com/v3/fixtures/lineups?fixture=215662&player=35845&type=startXI` `https://api-football-v1.p.rapidapi.com/v3/fixtures/lineups?fixture=215662&team=463&type=startXI&player=35845`
Try it
Result:
v3_fixtures_lineups_filtered_by_team_id
Get the lineups for a fixture. **Available datas** * Formation * Coach * Start XI * Substitutes > Lineups are available between 20 and 40 minutes before the fixture. **Players' positions on the grid** **X** = row and **Y** = column (X:Y) Line 1 **X** being the one of the goal and then for each line this number is incremented. The column **Y** will go from left to right, and incremented for each player of the line. `As a new feature, some irregularities may occur, do not hesitate to report them on our public Roadmap` **Update Frequency** : This endpoint is updated every 15 minutes. **Recommended Calls** : 1 call every 15 minutes for the fixtures in progress otherwise 1 call per day. > Here are several examples of what can be done   **Use Cases** Get all available lineups from one {fixture} `https://api-football-v1.p.rapidapi.com/v3/fixtures/lineups?fixture=215662` Get all available lineups from one {fixture} & {team} `https://api-football-v1.p.rapidapi.com/v3/fixtures/lineups?fixture=215662&team=463` Get all available lineups from one {fixture} & {player} `https://api-football-v1.p.rapidapi.com/v3/fixtures/lineups?fixture=215662&player=35845` Get all available lineups from one {fixture} & {type} `https://api-football-v1.p.rapidapi.com/v3/fixtures/lineups?fixture=215662&type=startXI` It’s possible to make requests by mixing the available parameters `https://api-football-v1.p.rapidapi.com/v3/fixtures/lineups?fixture=215662&player=35845&type=startXI` `https://api-football-v1.p.rapidapi.com/v3/fixtures/lineups?fixture=215662&team=463&type=startXI&player=35845`
Try it
Result:
v3_trophies_by_player_id
Get all available trophies for a player or a coach. **Update Frequency** : This endpoint is updated several times a week. **Recommended Calls** : 1 call per day. **Use Cases** Get all trophies from one {player} `https://api-football-v1.p.rapidapi.com/v3/trophies?player=276` Get all trophies from several {player} ids `https://api-football-v1.p.rapidapi.com/v3/trophies?players=276-278` Get all trophies from one {coach} `https://api-football-v1.p.rapidapi.com/v3/trophies?coach=2` Get all trophies from several {coachs} ids `https://api-football-v1.p.rapidapi.com/v3/trophies?coachs=2-6`
Try it
Result:
v3_trophies_by_coach_id
Get all available trophies for a player or a coach. **Update Frequency** : This endpoint is updated several times a week. **Recommended Calls** : 1 call per day. **Use Cases** Get all trophies from one {player} `https://api-football-v1.p.rapidapi.com/v3/trophies?player=276` Get all trophies from several {player} ids `https://api-football-v1.p.rapidapi.com/v3/trophies?players=276-278` Get all trophies from one {coach} `https://api-football-v1.p.rapidapi.com/v3/trophies?coach=2` Get all trophies from several {coachs} ids `https://api-football-v1.p.rapidapi.com/v3/trophies?coachs=2-6`
Try it
Result:
v3_trophies_by_players_ids
Get all available trophies for a player or a coach. **Update Frequency** : This endpoint is updated several times a week. **Recommended Calls** : 1 call per day. **Use Cases** Get all trophies from one {player} `https://api-football-v1.p.rapidapi.com/v3/trophies?player=276` Get all trophies from several {player} ids `https://api-football-v1.p.rapidapi.com/v3/trophies?players=276-278` Get all trophies from one {coach} `https://api-football-v1.p.rapidapi.com/v3/trophies?coach=2` Get all trophies from several {coachs} ids `https://api-football-v1.p.rapidapi.com/v3/trophies?coachs=2-6`
Try it
Result:
v3_trophies_by_coachs_ids
Get all available trophies for a player or a coach. **Update Frequency** : This endpoint is updated several times a week. **Recommended Calls** : 1 call per day. **Use Cases** Get all trophies from one {player} `https://api-football-v1.p.rapidapi.com/v3/trophies?player=276` Get all trophies from several {player} ids `https://api-football-v1.p.rapidapi.com/v3/trophies?players=276-278` Get all trophies from one {coach} `https://api-football-v1.p.rapidapi.com/v3/trophies?coach=2` Get all trophies from several {coachs} ids `https://api-football-v1.p.rapidapi.com/v3/trophies?coachs=2-6`
Try it
Result:
v3_odds
This endpoint returns in-play odds for fixtures in progress. Fixtures are added between 15 and 5 minutes before the start of the fixture. Once the fixture is over they are removed from the endpoint between 5 and 20 minutes. **No history is stored**. So fixtures that are about to start, fixtures in progress and fixtures that have just ended are available in this endpoint. **Update Frequency** : This endpoint is updated every 5 seconds.`*` `* This value can change in the range of 5 to 60 seconds` **INFORMATIONS ABOUT STATUS** ``` "status": { "stopped": false, // True if the fixture is stopped by the referee for X reason "blocked": false, // True if bets on this fixture are temporarily blocked "finished": false // True if the fixture has not started or if it is finished }, ``` **INFORMATIONS ABOUT VALUES** When several identical values exist for the same bet the `main` field is set to `True` for the bet being considered, the others will have the value `False`. The `main` field will be set to `True` only if several identical values exist for the same bet. When a value is unique for a bet the `main` value will always be `False` or `null`. **Example below** : ``` "id": 36, "name": "Over/Under Line", "values": [ { "value": "Over", "odd": "1.975", "handicap": "2", "main": true, // Bet to consider "suspended": false // True if this bet is temporarily suspended }, { "value": "Over", "odd": "3.45", "handicap": "2", "main": false, // Bet to no consider "suspended": false }, ]
Try it
Result:
v3_odds_bets
Get all available bets for in-play odds. All bets `id` can be used in endpoint `odds/live` as filters, **but are not compatible with endpoint `odds` for pre-match odds**. **Update Frequency** : This endpoint is updated every 60 seconds.
Try it
Result:
v3_sidelined_by_player_id
Get all available sidelined for a player or a coach. **Update Frequency** : This endpoint is updated several times a week. **Recommended Calls** : 1 call per day. **Use Cases** Get all from one {player} `https://api-football-v1.p.rapidapi.com/v3/sidelined?player=276` Get all from several {player} ids `https://api-football-v1.p.rapidapi.com/v3/sidelined?players=276-278` Get all from one {coach} `https://api-football-v1.p.rapidapi.com/v3/sidelined?coach=2` Get all from several {coachs} ids `https://api-football-v1.p.rapidapi.com/v3/sidelined?coachs=2-6`
Try it
Result:
v3_sidelined_by_coach_id
Get all available sidelined for a player or a coach. **Update Frequency** : This endpoint is updated several times a week. **Recommended Calls** : 1 call per day. **Use Cases** Get all from one {player} `https://api-football-v1.p.rapidapi.com/v3/sidelined?player=276` Get all from several {player} ids `https://api-football-v1.p.rapidapi.com/v3/sidelined?players=276-278` Get all from one {coach} `https://api-football-v1.p.rapidapi.com/v3/sidelined?coach=2` Get all from several {coachs} ids `https://api-football-v1.p.rapidapi.com/v3/sidelined?coachs=2-6`
Try it
Result:
v3_sidelined_by_players_ids
Get all available sidelined for a player or a coach. **Update Frequency** : This endpoint is updated several times a week. **Recommended Calls** : 1 call per day. **Use Cases** Get all from one {player} `https://api-football-v1.p.rapidapi.com/v3/sidelined?player=276` Get all from several {player} ids `https://api-football-v1.p.rapidapi.com/v3/sidelined?players=276-278` Get all from one {coach} `https://api-football-v1.p.rapidapi.com/v3/sidelined?coach=2` Get all from several {coachs} ids `https://api-football-v1.p.rapidapi.com/v3/sidelined?coachs=2-6`
Try it
Result:
v3_sidelined_by_coachs_ids
Get all available sidelined for a player or a coach. **Update Frequency** : This endpoint is updated several times a week. **Recommended Calls** : 1 call per day. **Use Cases** Get all from one {player} `https://api-football-v1.p.rapidapi.com/v3/sidelined?player=276` Get all from several {player} ids `https://api-football-v1.p.rapidapi.com/v3/sidelined?players=276-278` Get all from one {coach} `https://api-football-v1.p.rapidapi.com/v3/sidelined?coach=2` Get all from several {coachs} ids `https://api-football-v1.p.rapidapi.com/v3/sidelined?coachs=2-6`
Try it
Result:
v3_transfers_by_player_id
Get all available transfers for players and teams **Update Frequency** : This endpoint is updated several times a week. **Recommended Calls** : 1 call per day. **Use Cases** Get all transfers from one {player} `https://api-football-v1.p.rapidapi.com/v3/transfers?player=35845` Get all transfers from one {team} `https://api-football-v1.p.rapidapi.com/v3/transfers?team=463`
Try it
Result:
v3_transfers_by_team_id
Get all available transfers for players and teams **Update Frequency** : This endpoint is updated several times a week. **Recommended Calls** : 1 call per day. **Use Cases** Get all transfers from one {player} `https://api-football-v1.p.rapidapi.com/v3/transfers?player=35845` Get all transfers from one {team} `https://api-football-v1.p.rapidapi.com/v3/transfers?team=463`
Try it
Result:
v3_search_team
Get the list of available teams. The team `id` are **unique** in the API and teams keep it among all the leagues/cups in which they participate. > All the parameters of this endpoint can be used together. **This endpoint requires at least one parameter.** **Update Frequency** : This endpoint is updated several times a week. **Recommended Calls** : 1 call per day. **Use Cases** Get one team from one team {id} `https://api-football-v1.p.rapidapi.com/v3/teams?id=33` Get one team from one team {name} `https://api-football-v1.p.rapidapi.com/v3/teams?name=manchester united` Get all teams from one {league} & {season} `https://api-football-v1.p.rapidapi.com/v3/teams?league=39&season=2019` Get teams from one team {country} `https://api-football-v1.p.rapidapi.com/v3/teams?country=england` Allows you to search for a team in relation to a team {name} or {country} `https://api-football-v1.p.rapidapi.com/v3/teams?search=manches` `https://api-football-v1.p.rapidapi.com/v3/teams?search=England`
Try it
Result:
v3_search_country
Get the list of available countries. The `name` and `code` fields can be used in other endpoints as filters. > Examples available in Request samples "Use Cases". All the parameters of this endpoint can be used together. **Update Frequency** : This endpoint is updated each time a new league from a country not covered by the API is added. **Recommended Calls** : 1 call per day. **Use Cases** Get all available countries across all {seasons} and competitions `https://api-football-v1.p.rapidapi.com/v3/countries` Get all available countries from one country {name} `https://api-football-v1.p.rapidapi.com/v3/countries?name=england` Get all available countries from one country {code} `https://api-football-v1.p.rapidapi.com/v3/countries?code=fr` Allows you to search for a countries in relation to a country {name} `https://api-football-v1.p.rapidapi.com/v3/countries?search=engl`
Try it
Result:
v3_search_league
Get the list of available leagues and cups. The league `id` are **unique** in the API and leagues keep it across all `seasons` > Most of the parameters of this endpoint can be used together. **Update Frequency** : This endpoint is updated several times a day. **Recommended Calls** : 1 call per hour. **Use Cases** Allows to retrieve all the seasons available for a league/cup `https://api-football-v1.p.rapidapi.com/v3/leagues?id=39` Get all leagues from one league {name} `https://api-football-v1.p.rapidapi.com/v3/leagues?name=premier league` Get all leagues from one {country} You can find the available {country} by using the endpoint country `https://api-football-v1.p.rapidapi.com/v3/leagues?country=england` Get all leagues from one country {code} (GB, FR, IT etc..) You can find the available country {code} by using the endpoint country `https://api-football-v1.p.rapidapi.com/v3/leagues?code=gb` Get all leagues from one {season} You can find the available {season} by using the endpoint seasons `https://api-football-v1.p.rapidapi.com/v3/leagues?season=2019` Get one league from one league {id} & {season} `https://api-football-v1.p.rapidapi.com/v3/leagues?season=2019&id=39` Get all leagues in which the {team} has played at least one match `https://api-football-v1.p.rapidapi.com/v3/leagues?team=33` Allows you to search for a league in relation to a league {name} or {country} `https://api-football-v1.p.rapidapi.com/v3/leagues?search=premier league` `https://api-football-v1.p.rapidapi.com/v3/leagues?search=England` Get all leagues from one {type} `https://api-football-v1.p.rapidapi.com/v3/leagues?type=league` Get all leagues where the season is in progress or not `https://api-football-v1.p.rapidapi.com/v3/leagues?current=true` Get the last 99 leagues or cups added to the API `https://api-football-v1.p.rapidapi.com/v3/leagues?last=99` It’s possible to make requests by mixing the available parameters `https://api-football-v1.p.rapidapi.com/v3/leagues?season=2019&country=england&type=league` `https://api-football-v1.p.rapidapi.com/v3/leagues?team=85&season=2019` `https://api-football-v1.p.rapidapi.com/v3/leagues?id=61¤t=true&type=league`
Try it
Result:
v3_search_player
Get players statistics. The players `id` are unique in the API and players keep it among all the teams they have been in The statistics are calculated according to the team `id`, league `id` and `season`. You can find the available `seasons` by using the endpoint players seasons. This endpoint uses a **pagination system**, you can navigate between the different pages thanks to the `page` parameter. > **Pagination** : 20 results per page. **Update Frequency** : This endpoint is updated several times a week. **Recommended Calls** : 1 call per day. **Use Cases** Get all players statistics from one player {id} & {season} `https://api-football-v1.p.rapidapi.com/v3/players?id=19088&season=2018` Get all players statistics from one {team} & {season} `https://api-football-v1.p.rapidapi.com/v3/players?season=2018&team=33` `https://api-football-v1.p.rapidapi.com/v3/players?season=2018&team=33&page=2` Get all players statistics from one {league} & {season} `https://api-football-v1.p.rapidapi.com/v3/players?season=2018&league=61` `https://api-football-v1.p.rapidapi.com/v3/players?season=2018&league=61&page=4` Get all players statistics from one {league}, {team} & {season} `https://api-football-v1.p.rapidapi.com/v3/players?season=2018&league=61&team=33` `https://api-football-v1.p.rapidapi.com/v3/players?season=2018&league=61&team=33&page=5` Allows you to search for a player in relation to a player {name} `https://api-football-v1.p.rapidapi.com/v3/players?team=85&search=cavani` `https://api-football-v1.p.rapidapi.com/v3/players?league=61&search=cavani` `https://api-football-v1.p.rapidapi.com/v3/players?team=85&search=cavani&season=2018`
Try it
Result:
v3_search_coach
Get all the information about the coachs and their careers. **Update Frequency** : This endpoint is updated every day. **Recommended Calls** : 1 call per day. **Use Cases** Get coachs from one coach {id} `https://api-football-v1.p.rapidapi.com/v3/coachs?id=1` Get coachs from one {team} `https://api-football-v1.p.rapidapi.com/v3/coachs?team=33` Allows you to search for a coach in relation to a coach {name} `https://api-football-v1.p.rapidapi.com/v3/coachs?search=Klopp`
Try it
Result:
v3_search_venue
Get the list of available venues. The venue `id` are **unique** in the API. > All the parameters of this endpoint can be used together. **This endpoint requires at least one parameter.** **Update Frequency** : This endpoint is updated several times a week. **Recommended Calls** : 1 call per day. **Use Cases** Get one venue from venue {id} `https://api-football-v1.p.rapidapi.com/v3/venues?id=556` Get one venue from venue {name} `https://api-football-v1.p.rapidapi.com/v3/venues?name=Old Trafford` Get all venues from {city} `https://api-football-v1.p.rapidapi.com/v3/venues?city=manchester` Get venues from {country} `https://api-football-v1.p.rapidapi.com/v3/venues?country=england` Allows you to search for a venues in relation to a venue {name}, {city} or {country} `https://api-football-v1.p.rapidapi.com/v3/venues?search=trafford` `https://api-football-v1.p.rapidapi.com/v3/venues?search=manches` `https://api-football-v1.p.rapidapi.com/v3/venues?search=England`
Try it
Result:
v3_search_bet
Get all available bets. All bets `id` can be used in endpoint odds as filters. **Update Frequency** : This endpoint is updated several times a week. **Recommended Calls** : 1 call per day. **Use Cases** Get all available bets `https://api-football-v1.p.rapidapi.com/v3/odds/bets` Get bet from one {id} `https://api-football-v1.p.rapidapi.com/v3/odds/bets?id=1` Allows you to search for a bet in relation to a bets {name} `https://api-football-v1.p.rapidapi.com/v3/odds/bets?search=winner`
Try it
Result:
v3_search_bookmaker
Get all available bookmakers. All bookmakers `id` can be used in endpoint odds as filters. **Update Frequency** : This endpoint is updated several times a week. **Recommended Calls** : 1 call per day. **Use Cases** Get all available bookmakers `https://api-football-v1.p.rapidapi.com/v3/odds/bookmakers` Get bookmaker from one {id} `https://api-football-v1.p.rapidapi.com/v3/odds/bookmakers?id=1` Allows you to search for a bookmaker in relation to a bookmakers {name} `https://api-football-v1.p.rapidapi.com/v3/odds/bookmakers?search=Betfair`
Try it
Result:
v3_top_scorers
Get the 20 best players for a league or cup. **How it is calculated:** * 1 : The player that has scored the higher number of goals * 2 : The player that has scored the fewer number of penalties * 3 : The player that has delivered the higher number of goal assists * 4 : The player that scored their goals in the higher number of matches * 5 : The player that played the fewer minutes * 6 : The player that plays for the team placed higher on the table * 7 : The player that received the fewer number of red cards * 8 : The player that received the fewer number of yellow cards **Update Frequency** : This endpoint is updated several times a week. **Recommended Calls** : 1 call per day.
Try it
Result:
v3_top_assists
Get the 20 best players assists for a league or cup. **How it is calculated:** * 1 : The player that has delivered the higher number of goal assists * 2 : The player that has scored the higher number of goals * 3 : The player that has scored the fewer number of penalties * 4 : The player that assists in the higher number of matches * 5 : The player that played the fewer minutes * 6 : The player that received the fewer number of red cards * 7 : The player that received the fewer number of yellow cards **Update Frequency** : This endpoint is updated several times a week. **Recommended Calls** : 1 call per day.
Try it
Result:
v3_top_red_cards
Get the 20 players with the most red cards for a league or cup. **How it is calculated:** * 1 : The player that received the higher number of red cards * 2 : The player that received the higher number of yellow cards * 3 : The player that assists in the higher number of matches * 4 : The player that played the fewer minutes **Update Frequency** : This endpoint is updated several times a week. **Recommended Calls** : 1 call per day.
Try it
Result:
v3_top_yellow_cards
Get the 20 players with the most yellow cards for a league or cup. **How it is calculated:** * 1 : The player that received the higher number of yellow cards * 2 : The player that received the higher number of red cards * 3 : The player that assists in the higher number of matches * 4 : The player that played the fewer minutes **Update Frequency** : This endpoint is updated several times a week. **Recommended Calls** : 1 call per day.
Try it
Result:
v3_venues_by_venue_id
Get the list of available venues. The venue `id` are **unique** in the API. > All the parameters of this endpoint can be used together. **This endpoint requires at least one parameter.** **Update Frequency** : This endpoint is updated several times a week. **Recommended Calls** : 1 call per day. **Use Cases** Get one venue from venue {id} `https://api-football-v1.p.rapidapi.com/v3/venues?id=556` Get one venue from venue {name} `https://api-football-v1.p.rapidapi.com/v3/venues?name=Old Trafford` Get all venues from {city} `https://api-football-v1.p.rapidapi.com/v3/venues?city=manchester` Get venues from {country} `https://api-football-v1.p.rapidapi.com/v3/venues?country=england` Allows you to search for a venues in relation to a venue {name}, {city} or {country} `https://api-football-v1.p.rapidapi.com/v3/venues?search=trafford` `https://api-football-v1.p.rapidapi.com/v3/venues?search=manches` `https://api-football-v1.p.rapidapi.com/v3/venues?search=England`
Try it
Result:
v3_venues_by_country_name
Get the list of available venues. The venue `id` are **unique** in the API. > All the parameters of this endpoint can be used together. **This endpoint requires at least one parameter.** **Update Frequency** : This endpoint is updated several times a week. **Recommended Calls** : 1 call per day. **Use Cases** Get one venue from venue {id} `https://api-football-v1.p.rapidapi.com/v3/venues?id=556` Get one venue from venue {name} `https://api-football-v1.p.rapidapi.com/v3/venues?name=Old Trafford` Get all venues from {city} `https://api-football-v1.p.rapidapi.com/v3/venues?city=manchester` Get venues from {country} `https://api-football-v1.p.rapidapi.com/v3/venues?country=england` Allows you to search for a venues in relation to a venue {name}, {city} or {country} `https://api-football-v1.p.rapidapi.com/v3/venues?search=trafford` `https://api-football-v1.p.rapidapi.com/v3/venues?search=manches` `https://api-football-v1.p.rapidapi.com/v3/venues?search=England`
Try it
Result:
v3_injuries_by_team_id_and_season
Get the list of players not participating in the fixtures for various reasons such as `suspended`, `injured` for example. Being a new endpoint, the data is only available from April 2021. **There are two types:** * `Missing Fixture` : The player will not play the fixture. * `Questionable` : The information is not yet 100% sure, the player may eventually play the fixture. > Examples available in Request samples "Use Cases". > All the parameters of this endpoint can be used together. **This endpoint requires at least one parameter.** **Update Frequency** : This endpoint is updated every 4 hours. **Recommended Calls** : 1 call per day. **Use Cases** Get all available injuries from one {league} & {season} `https://api-football-v1.p.rapidapi.com/v3/injuries?league=2&season=2020` Get all available injuries from one {fixture} `https://api-football-v1.p.rapidapi.com/v3/injuries?fixture=686314` Get all available injuries from one {team} & {season} `https://api-football-v1.p.rapidapi.com/v3/injuries?team=85&season=2020` Get all available injuries from one {player} & {season} `https://api-football-v1.p.rapidapi.com/v3/injuries?player=865&season=2020` Get all available injuries from one {date} `https://api-football-v1.p.rapidapi.com/v3/injuries?date=2021-04-07` It’s possible to make requests by mixing the available parameters `https://api-football-v1.p.rapidapi.com/v3/injuries?league=2&season=2020&team=85` `https://api-football-v1.p.rapidapi.com/v3/injuries?league=2&season=2020&player=865` `https://api-football-v1.p.rapidapi.com/v3/injuries?date=2021-04-07&timezone=Europe/London&team=85` `https://api-football-v1.p.rapidapi.com/v3/injuries?date=2021-04-07&league=61`
Try it
Result:
v3_injuries_by_player_id_and_season
Get the list of players not participating in the fixtures for various reasons such as `suspended`, `injured` for example. Being a new endpoint, the data is only available from April 2021. **There are two types:** * `Missing Fixture` : The player will not play the fixture. * `Questionable` : The information is not yet 100% sure, the player may eventually play the fixture. > Examples available in Request samples "Use Cases". > All the parameters of this endpoint can be used together. **This endpoint requires at least one parameter.** **Update Frequency** : This endpoint is updated every 4 hours. **Recommended Calls** : 1 call per day. **Use Cases** Get all available injuries from one {league} & {season} `https://api-football-v1.p.rapidapi.com/v3/injuries?league=2&season=2020` Get all available injuries from one {fixture} `https://api-football-v1.p.rapidapi.com/v3/injuries?fixture=686314` Get all available injuries from one {team} & {season} `https://api-football-v1.p.rapidapi.com/v3/injuries?team=85&season=2020` Get all available injuries from one {player} & {season} `https://api-football-v1.p.rapidapi.com/v3/injuries?player=865&season=2020` Get all available injuries from one {date} `https://api-football-v1.p.rapidapi.com/v3/injuries?date=2021-04-07` It’s possible to make requests by mixing the available parameters `https://api-football-v1.p.rapidapi.com/v3/injuries?league=2&season=2020&team=85` `https://api-football-v1.p.rapidapi.com/v3/injuries?league=2&season=2020&player=865` `https://api-football-v1.p.rapidapi.com/v3/injuries?date=2021-04-07&timezone=Europe/London&team=85` `https://api-football-v1.p.rapidapi.com/v3/injuries?date=2021-04-07&league=61`
Try it
Result:
v3_injuries_by_fixture_id
Get the list of players not participating in the fixtures for various reasons such as `suspended`, `injured` for example. Being a new endpoint, the data is only available from April 2021. **There are two types:** * `Missing Fixture` : The player will not play the fixture. * `Questionable` : The information is not yet 100% sure, the player may eventually play the fixture. > Examples available in Request samples "Use Cases". > All the parameters of this endpoint can be used together. **This endpoint requires at least one parameter.** **Update Frequency** : This endpoint is updated every 4 hours. **Recommended Calls** : 1 call per day. **Use Cases** Get all available injuries from one {league} & {season} `https://api-football-v1.p.rapidapi.com/v3/injuries?league=2&season=2020` Get all available injuries from one {fixture} `https://api-football-v1.p.rapidapi.com/v3/injuries?fixture=686314` Get all available injuries from one {team} & {season} `https://api-football-v1.p.rapidapi.com/v3/injuries?team=85&season=2020` Get all available injuries from one {player} & {season} `https://api-football-v1.p.rapidapi.com/v3/injuries?player=865&season=2020` Get all available injuries from one {date} `https://api-football-v1.p.rapidapi.com/v3/injuries?date=2021-04-07` It’s possible to make requests by mixing the available parameters `https://api-football-v1.p.rapidapi.com/v3/injuries?league=2&season=2020&team=85` `https://api-football-v1.p.rapidapi.com/v3/injuries?league=2&season=2020&player=865` `https://api-football-v1.p.rapidapi.com/v3/injuries?date=2021-04-07&timezone=Europe/London&team=85` `https://api-football-v1.p.rapidapi.com/v3/injuries?date=2021-04-07&league=61`
Try it
Result:
v3_injuries_by_league_id_and_season
Get the list of players not participating in the fixtures for various reasons such as `suspended`, `injured` for example. Being a new endpoint, the data is only available from April 2021. **There are two types:** * `Missing Fixture` : The player will not play the fixture. * `Questionable` : The information is not yet 100% sure, the player may eventually play the fixture. > Examples available in Request samples "Use Cases". > All the parameters of this endpoint can be used together. **This endpoint requires at least one parameter.** **Update Frequency** : This endpoint is updated every 4 hours. **Recommended Calls** : 1 call per day. **Use Cases** Get all available injuries from one {league} & {season} `https://api-football-v1.p.rapidapi.com/v3/injuries?league=2&season=2020` Get all available injuries from one {fixture} `https://api-football-v1.p.rapidapi.com/v3/injuries?fixture=686314` Get all available injuries from one {team} & {season} `https://api-football-v1.p.rapidapi.com/v3/injuries?team=85&season=2020` Get all available injuries from one {player} & {season} `https://api-football-v1.p.rapidapi.com/v3/injuries?player=865&season=2020` Get all available injuries from one {date} `https://api-football-v1.p.rapidapi.com/v3/injuries?date=2021-04-07` It’s possible to make requests by mixing the available parameters `https://api-football-v1.p.rapidapi.com/v3/injuries?league=2&season=2020&team=85` `https://api-football-v1.p.rapidapi.com/v3/injuries?league=2&season=2020&player=865` `https://api-football-v1.p.rapidapi.com/v3/injuries?date=2021-04-07&timezone=Europe/London&team=85` `https://api-football-v1.p.rapidapi.com/v3/injuries?date=2021-04-07&league=61`
Try it
Result:
v3_injuries_by_date
Get the list of players not participating in the fixtures for various reasons such as `suspended`, `injured` for example. Being a new endpoint, the data is only available from April 2021. **There are two types:** * `Missing Fixture` : The player will not play the fixture. * `Questionable` : The information is not yet 100% sure, the player may eventually play the fixture. > Examples available in Request samples "Use Cases". > All the parameters of this endpoint can be used together. **This endpoint requires at least one parameter.** **Update Frequency** : This endpoint is updated every 4 hours. **Recommended Calls** : 1 call per day. **Use Cases** Get all available injuries from one {league} & {season} `https://api-football-v1.p.rapidapi.com/v3/injuries?league=2&season=2020` Get all available injuries from one {fixture} `https://api-football-v1.p.rapidapi.com/v3/injuries?fixture=686314` Get all available injuries from one {team} & {season} `https://api-football-v1.p.rapidapi.com/v3/injuries?team=85&season=2020` Get all available injuries from one {player} & {season} `https://api-football-v1.p.rapidapi.com/v3/injuries?player=865&season=2020` Get all available injuries from one {date} `https://api-football-v1.p.rapidapi.com/v3/injuries?date=2021-04-07` It’s possible to make requests by mixing the available parameters `https://api-football-v1.p.rapidapi.com/v3/injuries?league=2&season=2020&team=85` `https://api-football-v1.p.rapidapi.com/v3/injuries?league=2&season=2020&player=865` `https://api-football-v1.p.rapidapi.com/v3/injuries?date=2021-04-07&timezone=Europe/London&team=85` `https://api-football-v1.p.rapidapi.com/v3/injuries?date=2021-04-07&league=61`
Try it
Result:
v3_injuries_by_multiple_fixtures_ids
Get the list of players not participating in the fixtures for various reasons such as `suspended`, `injured` for example. Being a new endpoint, the data is only available from April 2021. **There are two types:** * `Missing Fixture` : The player will not play the fixture. * `Questionable` : The information is not yet 100% sure, the player may eventually play the fixture. > Examples available in Request samples "Use Cases". > All the parameters of this endpoint can be used together. **This endpoint requires at least one parameter.** **Update Frequency** : This endpoint is updated every 4 hours. **Recommended Calls** : 1 call per day. **Use Cases** Get all available injuries from one {league} & {season} `https://api-football-v1.p.rapidapi.com/v3/injuries?league=2&season=2020` Get all available injuries from one {fixture} `https://api-football-v1.p.rapidapi.com/v3/injuries?fixture=686314` // Get all available injuries from severals fixtures {ids} get("https://v3.football.api-sports.io/injuries?ids=686314-686315-686316-686317-686318-686319-686320"); Get all available injuries from one {team} & {season} `https://api-football-v1.p.rapidapi.com/v3/injuries?team=85&season=2020` Get all available injuries from one {player} & {season} `https://api-football-v1.p.rapidapi.com/v3/injuries?player=865&season=2020` Get all available injuries from one {date} `https://api-football-v1.p.rapidapi.com/v3/injuries?date=2021-04-07` It’s possible to make requests by mixing the available parameters `https://api-football-v1.p.rapidapi.com/v3/injuries?league=2&season=2020&team=85` `https://api-football-v1.p.rapidapi.com/v3/injuries?league=2&season=2020&player=865` `https://api-football-v1.p.rapidapi.com/v3/injuries?date=2021-04-07&timezone=Europe/London&team=85` `https://api-football-v1.p.rapidapi.com/v3/injuries?date=2021-04-07&league=61`
Try it
Result:
v3_coachs_by_team_id
Get all the information about the coachs and their careers. **Update Frequency** : This endpoint is updated every day. **Recommended Calls** : 1 call per day. **Use Cases** Get coachs from one coach {id} `https://api-football-v1.p.rapidapi.com/v3/coachs?id=1` Get coachs from one {team} `https://api-football-v1.p.rapidapi.com/v3/coachs?team=33` Allows you to search for a coach in relation to a coach {name} `https://api-football-v1.p.rapidapi.com/v3/coachs?search=Klopp`
Try it
Result:
v3_coachs_by_coach_id
Get all the information about the coachs and their careers. **Update Frequency** : This endpoint is updated every day. **Recommended Calls** : 1 call per day. **Use Cases** Get coachs from one coach {id} `https://api-football-v1.p.rapidapi.com/v3/coachs?id=1` Get coachs from one {team} `https://api-football-v1.p.rapidapi.com/v3/coachs?team=33` Allows you to search for a coach in relation to a coach {name} `https://api-football-v1.p.rapidapi.com/v3/coachs?search=Klopp`
Try it
Result:
fixture_fixture_id
Get all statistics game from one fixture
Try it
Result:
league_table_league_id
Get standings from one league or cup.
Try it
Result:
season_team_id
Get coach and players from one team and season
Try it
Result:
team_id_date
Get team statistics for a one league/cup with a limit date
Try it
Result:
lineups_fixture_id
Get line ups from one fixture
Try it
Result:
country_name_season
Get all available leagues from country name or country code
Try it
Result:
league_id_team_id
Get team statistics for a one league/cup.
Try it
Result:
team_1_team_2
Get all Head 2 Heads between 2 teams
Try it
Result:
standings_league_id
!!! DEPRECIATED, USE "leagueTable endpoint" INSTEAD
Try it
Result:
id_fixture_id
Get one fixture from ID
Try it
Result:
odds_fixture_id
Get all available odds from one fixture
Try it
Result:
events_fixture_id
Get all available events from one fixture | Match events are updated at half-time and at the end of the match.
Try it
Result:
team_team_id
Get all fixtures from one team
Try it
Result:
league_league_id
Get all fixtures from one league or cup
Try it
Result:
fixtures_live
Get all fixtures in play
Try it
Result:
date_date
Get all fixtures from one date
Try it
Result:
season_season
Get all leagues from season
Try it
Result:
leagues
Get all available leagues
Try it
Result:
seasons
Get all available seasons
Try it
Result:
countries
Get all available countries
Try it
Result:
timezone
Get the list of available timezone to be used in the fixtures endpoint. > This endpoint does not require any parameters.
Try it
Result:
predictions
Get predictions about a fixture. The predictions are made using several algorithms including the poisson distribution, comparison of team statistics, last matches, players etc…
Try it
Result:
topscorers
Get the 20 best players for a league/cup **Update Frequency** : Several times a week **Recommended Calls** : 1 call per day
Try it
Result:
last_fixtures_from_team_id
Get x last fixtures from one team **Update Frequency** : Every 15 seconds **Recommended Calls** : 1 call per minute for the leagues, teams, fixtures who have at least one fixture in progress otherwise 1 call per day
Try it
Result:
next_fixtures_from_team_id
Get x next fixtures from one team **Update Frequency** : Every 15 seconds **Recommended Calls** : 1 call per minute for the leagues, teams, fixtures who have at least one fixture in progress otherwise 1 call per day
Try it
Result:
last_fixtures_from_league_id
Get X last fixtures from one league or cup **Update Frequency** : Every 15 seconds **Recommended Calls** : 1 call per minute for the leagues, teams, fixtures who have at least one fixture in progress otherwise 1 call per day
Try it
Result:
next_fixtures_from_league_id
Get X next fixtures from one league or cup **Update Frequency** : Every 15 seconds **Recommended Calls** : 1 call per minute for the leagues, teams, fixtures who have at least one fixture in progress otherwise 1 call per day
Try it
Result:
fixtures_from_league_id_round
Get all fixtures from one league or cup filter by round, All spaces are replaced by underscore “_” **Update Frequency** : Every 15 seconds **Recommended Calls** : 1 call per minute for the leagues, teams, fixtures who have at least one fixture in progress otherwise 1 call per day
Try it
Result:
fixtures_in_play_filtered_by_league_ids
Get all fixtures in play filter by leagues ids (several leagues can be added by separating them with "-") In this request `events` are returned in the response **Update Frequency** : Every 15 seconds **Recommended Calls** : 1 call per minute for the leagues, teams, fixtures who have at least one fixture in progress otherwise 1 call per day
Try it
Result:
fixtures_from_league_id_date
Get all fixtures from one league or cup filter by date **Update Frequency** : Every 15 seconds **Recommended Calls** : 1 call per minute for the leagues, teams, fixtures who have at least one fixture in progress otherwise 1 call per day
Try it
Result:
fixtures_from_team_league_ids
Get all fixtures from one team filter by league **Update Frequency** : Every 15 seconds **Recommended Calls** : 1 call per minute for the leagues, teams, fixtures who have at least one fixture in progress otherwise 1 call per day
Try it
Result:
fixtures_from_league_id
Get all fixtures from one league or cup **Update Frequency** : Every 15 seconds **Recommended Calls** : 1 call per minute for the leagues, teams, fixtures who have at least one fixture in progress otherwise 1 call per day
Try it
Result:
fixtures_from_team_id
Get all fixtures from one team accross all seasons **Update Frequency** : Every 15 seconds **Recommended Calls** : 1 call per minute for the leagues, teams, fixtures who have at least one fixture in progress otherwise 1 call per day
Try it
Result:
h2h_between2_teams
Get all Head 2 Heads between 2 teams **Update Frequency** : Every 15 seconds **Recommended Calls** : 1 call per minute for the leagues, teams, fixtures who have at least one fixture in progress otherwise 1 call per day
Try it
Result:
fixtures_from_one_date
Get all fixtures from one date **Update Frequency** : Every 15 seconds **Recommended Calls** : 1 call per minute for the leagues, teams, fixtures who have at least one fixture in progress otherwise 1 call per day
Try it
Result:
fixtures_from_id
Get one fixture from `ID` In this request `events`, `lineups`, `statistics` and `players statistics` are returned in the response **Update Frequency** : Every 15 seconds **Recommended Calls** : 1 call per minute for the leagues, teams, fixtures who have at least one fixture in progress otherwise 1 call per day
Try it
Result:
fixtures_in_play
Get all fixtures in play In this request `events` are returned in the response **Update Frequency** : Every 15 seconds **Recommended Calls** : 1 call per minute for the leagues, teams, fixtures who have at least one fixture in progress otherwise 1 call per day
Try it
Result:
teams_from_league_id
Get all teams from one league The `team id` are unique in the API and teams keep it among all the leagues/cups in which they participate
Try it
Result:
team_from_id
Get one team from ID The `team id` are unique in the API and teams keep it among all the leagues/cups in which they participate.
Try it
Result:
seasons_availables
All seasons are only **4-digit keys**, so for a league whose season is `2018-2019` like the English Premier League (EPL), the `2018-2019` season in the API will be `2018`. All `seasons` can be used in other endpoints as filters.
Try it
Result:
countries_available
Get the list of available countries. The `name` and `code` fields can be used in other endpoints as filters.
Try it
Result:
leagues_by_type_filtered_by_season
Allows to retrieve league by type (league or cup) and filtered by country
Try it
Result:
leagues_by_type_filtered_by_country_and_season
Allows to retrieve league by type (league or cup) and filtered by country and season
Try it
Result:
leagues_by_type_filtered_by_country
Allows to retrieve league by type (league or cup) and filtered by country
Try it
Result:
leagues_by_type
Allows to retrieve league by type (league or cup)
Try it
Result:
current_seasons_for_all_leagues_from_one_country
Allows to retrieve all the current seasons for all leagues and cups from one country
Try it
Result:
current_seasons_for_all_leagues
Allows to retrieve all the current seasons for all leagues and cups
Try it
Result:
leagues_from_team_id_filtered_by_season
Get all leagues in which the team has played at least one match filter by season
Try it
Result:
leagues_from_team_id
Get all leagues in which the team has played at least one match
Try it
Result:
available_seasons_for_aleague_filtered_by_season
Allows to retrieve all the seasons available in the API for a league/cup with the possibility to filter by {season}
Try it
Result:
available_seasons_for_aleague
Allows to retrieve all the seasons available in the API for a league/cup with the possibility to filter by {season}
Try it
Result:
leagues_from_country
Get all available leagues from country name or country code
Try it
Result:
leagues_from_season
Get all leagues from season
Try it
Result:
leagues_from_id
Get one league from ID
Try it
Result:
leagues_available
Get all available leagues
Try it
Result:
odds_from_one_date
Get all available odds from one date you can filter by bookmaker or label like this : - /v2/odds/date/{yyyy-mm-dd}/bookmaker/{bookmakerid} - /v2/odds/date/{yyyy-mm-dd}/label/{labelid} **Update Frequency** : This endpoint is updated every day **Recommended Calls** : 1 call per day
Try it
Result:
odds_mapping
Get the list of available odds **Update Frequency** : Several times a week **Recommended Calls** : 1 call per day
Try it
Result:
odds_from_fixture_id
Get all available odds from one fixture you can filter by bookmaker or label like this : - /v2/odds/fixture/{fixture_id}/bookmaker/{bookmaker_id} - /v2/odds/fixture/{fixture_id}/label/{label_id} **Update Frequency** : Every day **Recommended Calls** : 1 call per day
Try it
Result:
odds_from_league_id
Get all available odds from one league you can filter by bookmaker or label like this : - /v2/odds/league/{league_id}/bookmaker/{bookmaker_id} - /v2/odds/league/{league_id}/label/{label_id} **Update Frequency** : Every day **Recommended Calls** : 1 call per day
Try it
Result:
labels_available
Get all available labels All labels `id` can be used in endpoint odds as filters **Update Frequency** : Several times a week **Recommended Calls** : 1 call per day
Try it
Result:
bookmakers_available
Get all available bookmakers All bookmakers `id` can be used in endpoint odds as filters **Update Frequency** : Several times a week **Recommended Calls** : 1 call per day
Try it
Result:
events_available_from_fixture_id
Get the events from a fixture **Update Frequency** : Every 15 seconds **Recommended Calls** : 1 call per minute for the fixtures in progress otherwise 1 call per day
Try it
Result:
standings
Get the standings for a league / cup **Update Frequency** : Every hour **Recommended Calls** : 1 call per hour for the leagues or teams who have at least one fixture in progress otherwise 1 call per day.
Try it
Result:
team_statistics
Get team statistics for a one league/cup **Update Frequency** : Every 15 seconds **Recommended Calls** : 1 call per minute for the teams who have at least one fixture in progress otherwise 1 call per week
Try it
Result:
fixtures_statistics
Get all statistics from one fixture **Update Frequency** : Every minute **Recommended Calls** : 1 call every minute for the fixtures in progress otherwise 1 call per day
Try it
Result:
team_statistics_filtered_by_date
Get team statistics for a one league/cup with a limit date **Update Frequency** : Every 15 seconds **Recommended Calls** : 1 call per minute for the teams who have at least one fixture in progress otherwise 1 call per week
Try it
Result:
players_statistics_from_fixture_id
Get all players statistics from one fixture **Update Frequency** : Every minute **Recommended Calls** : 1 call every minute for the fixtures in progress otherwise 1 call per day
Try it
Result:
players_squad_from_team
Get all players from one team for one season **Update Frequency** : Several times a week **Recommended Calls** : 1 call per day
Try it
Result:
seasons_available_for_players
Get all available seasons for players statistics The `season` returned by this endpoint are only available for `players endpoint` **Update Frequency** : This endpoint is updated every day **Recommended Calls** : 1 call per day
Try it
Result:
players_statistics_filtered_by_season
Get all statistics from one player filtered by season Statistics are calculated according to the `team_id`, `league_id` and `season` **Update Frequency** : Several times a week **Recommended Calls** : 1 call per day
Try it
Result:
players_statistics_from_team_filtered_by_season
Get all players statistics from one team filter by season Statistics are calculated according to the `team_id`, `league_id` and `season` **Update Frequency** : Several times a week **Recommended Calls** : 1 call per day
Try it
Result:
players_statistics_from_team
Get all players statistics from one team Statistics are calculated according to the `team_id`, `league_id` and `season` **Update Frequency** : Several times a week **Recommended Calls** : 1 call per day
Try it
Result:
players_statistics
Get all statistics from one player Statistics are calculated according to the `team_id`, `league_id` and `season` **Update Frequency** : Several times a week **Recommended Calls** : 1 call per day
Try it
Result:
lineups_available_from_fixture_id
Get lineups from one fixture **Update Frequency** : Every 15 minutes **Recommended Calls** : 1 call every 15 minutes for the fixtures in progress otherwise 1 call per day
Try it
Result:
trophies_from_player_id
Get all available trophies for a players **Update Frequency** : Several times a week **Recommended Calls** : 1 call per day
Try it
Result:
trophies_from_coach_id
Get all available trophies for a coach **Update Frequency** : Several times a week **Recommended Calls** : 1 call per day
Try it
Result:
transfers_from_team_id
Get all available transfers for teams **Update Frequency** : Several times a week **Recommended Calls** : 1 call per day
Try it
Result:
transfers_from_player_id
Get all available transfers for players **Update Frequency** : Several times a week **Recommended Calls** : 1 call per day
Try it
Result:
sidelined_from_player_id
Get all available sidelined for a player **Update Frequency** : Several times a week **Recommended Calls** : 1 call per day
Try it
Result:
sidelined_from_coach_id
Get all available sidelined for a coach **Update Frequency** : Several times a week **Recommended Calls** : 1 call per day
Try it
Result:
current_round_for_aleague
Get current round from one league or cup, All spaces are replaced by underscore “_” **Update Frequency** : Every day. **Recommended Calls** : 1 call per day.
Try it
Result:
rounds_available_for_aleague
Get all rounds available from one league or cup, All spaces are replaced by underscore “_” **Update Frequency** : Every day. **Recommended Calls** : 1 call per day.
Try it
Result:
search_aplayer
Allows you to search for a player in relation to a player {name}
Try it
Result:
search_acoach
Allows you to search for a coach in relation to his name
Try it
Result:
search_ateam
Allows you to search for a team in relation to a {country} or team {name}. Spaces must be replaced by underscore. It is not necessary to put the {keyWord} in full, 3 characters are enough to search.
Try it
Result:
search_aleague
Allows you to search for a league in relation to a {country} or league {name}. Spaces must be replaced by underscore. It is not necessary to put the {keyWord} in full, 3 characters are enough to search.
Try it
Result:
coachs_from_team_id
Get all the information about the coachs and their careers Update Frequency : Every day Recommended Calls : 1 call per day
Try it
Result:
coach_from_id
Get all the information about the coachs and their careers **Update Frequency** : Every day **Recommended Calls** : 1 call per day
Try it
Result:
odds_from_league_id_filtered_by_bookmaker
Get all available odds from one league you can filter by bookmaker or label like this : - /v2/odds/league/{league_id}/bookmaker/{bookmaker_id} - /v2/odds/league/{league_id}/label/{label_id} **Update Frequency** : Every day **Recommended Calls** : 1 call per day
Try it
Result:
odds_from_league_id_filtered_by_label
Get all available odds from one league you can filter by bookmaker or label like this : - /v2/odds/league/{league_id}/bookmaker/{bookmaker_id} - /v2/odds/league/{league_id}/label/{label_id} **Update Frequency** : Every day **Recommended Calls** : 1 call per day
Try it
Result:
odds_from_fixture_id_filter_by_label
Get all available odds from one fixture you can filter by bookmaker or label like this : - /v2/odds/fixture/{fixture_id}/bookmaker/{bookmaker_id} - /v2/odds/fixture/{fixture_id}/label/{label_id} **Update Frequency** : Every day **Recommended Calls** : 1 call per day
Try it
Result:
odds_from_fixture_id_filter_by_bookemaker
Get all available odds from one fixture you can filter by bookmaker or label like this : - /v2/odds/fixture/{fixture_id}/bookmaker/{bookmaker_id} - /v2/odds/fixture/{fixture_id}/label/{label_id} **Update Frequency** : Every day **Recommended Calls** : 1 call per day