{"status":"ok","response":{"items":[{"cid":"1382","cname":"FIFA World Cup","logo":"https:\/\/gcdnimages.entitysport.com\/soccer\/competition\/logo_5d515bc2320a6.png","matches":[{"mid":"305534","round":"Round of 32","group":"","result":{"home":"2","away":"1","winner":"home"},"teams":{"home":{"tid":"11","tname":"England","logo":"https:\/\/gcdnimages.entitysport.com\/soccer\/team-s2\/4713.png","fullname":"England","abbr":"ENG","card":""},"away":{"tid":"1298","tname":"Congo DR","logo":"https:\/\/gcdnimages.entitysport.com\/soccer\/team-s2\/4823.png","fullname":"DR Congo","abbr":"COD","card":""}},"periods":{"p1":{"home":0,"away":1},"p2":{"home":2,"away":0},"ft":{"home":2,"away":1}},"datestart":"2026-07-01 16:00:00","timestampstart":1782921600,"time":"90","status":"2"},{"mid":"305531","round":"Round of 32","group":"","result":{"home":"2","away":"0","winner":"home"},"teams":{"home":{"tid":"25","tname":"Mexico","logo":"https:\/\/gcdnimages.entitysport.com\/soccer\/team-s2\/4781.png","fullname":"Mexico","abbr":"MEX","card":""},"away":{"tid":"1154","tname":"Ecuador","logo":"https:\/\/gcdnimages.entitysport.com\/soccer\/team-s2\/4757.png","fullname":"Ecuador","abbr":"ECU","card":"1"}},"periods":{"p1":{"home":2,"away":0},"p2":{"home":0,"away":0},"ft":{"home":2,"away":0}},"datestart":"2026-07-01 02:00:00","timestampstart":1782871200,"time":"90","status":"2"},{"mid":"305529","round":"Round of 32","group":"","result":{"home":"3","away":"0","winner":"home"},"teams":{"home":{"tid":"2","tname":"France","logo":"https:\/\/gcdnimages.entitysport.com\/soccer\/team-s2\/4481.png","fullname":"France","abbr":"FRA","card":""},"away":{"tid":"3","tname":"Sweden","logo":"https:\/\/gcdnimages.entitysport.com\/soccer\/team-s2\/4688.png","fullname":"Sweden","abbr":"SWE","card":""}},"periods":{"p1":{"home":1,"away":0},"p2":{"home":2,"away":0},"ft":{"home":3,"away":0}},"datestart":"2026-06-30 21:00:00","timestampstart":1782853200,"time":"90","status":"2"}]},{"cid":"1893","cname":"Brasileiro Serie B","logo":"https:\/\/gcdnimages.entitysport.com\/soccer\/competition\/162.png","matches":[{"mid":"394492","round":"15","group":"","result":{"home":"0","away":"1","winner":"away"},"teams":{"home":{"tid":"14389","tname":"botafogosp","logo":"https:\/\/gcdnimages.entitysport.com\/soccer\/team-s2\/1979.png","fullname":"botafogosp","abbr":"BOT","card":""},"away":{"tid":"147","tname":"CRB AL","logo":"https:\/\/gcdnimages.entitysport.com\/soccer\/team-s2\/22032.png","fullname":"CRB AL","abbr":"CRB","card":""}},"periods":{"p1":{"home":0,"away":1},"p2":{"home":0,"away":0},"ft":{"home":0,"away":1}},"datestart":"2026-06-30 23:00:00","timestampstart":1782860400,"time":"90","status":"2"}]},{"cid":"2155","cname":"Canadian Premier League","logo":"https:\/\/gcdnimages.entitysport.com\/soccer\/competition\/167.png","matches":[{"mid":"449840","round":"1","group":"","result":{"home":"3","away":"2","winner":"home"},"teams":{"home":{"tid":"3923","tname":"Forge","logo":"https:\/\/gcdnimages.entitysport.com\/soccer\/team-s2\/313716.png","fullname":"Forge FC Hamilton","abbr":"FOR","card":""},"away":{"tid":"11421","tname":"Vancouver FC","logo":"https:\/\/gcdnimages.entitysport.com\/soccer\/team-s2\/463097.png","fullname":"Vancouver FC","abbr":"VAN","card":""}},"periods":{"p1":{"home":0,"away":2},"p2":{"home":3,"away":0},"ft":{"home":3,"away":2}},"datestart":"2026-07-01 17:00:00","timestampstart":1782925200,"time":"90","status":"2"}]},{"cid":"2156","cname":"Vysshaya Liga","logo":"https:\/\/gcdnimages.entitysport.com\/soccer\/competition\/73.png","matches":[{"mid":"450132","round":"14","group":"","result":{"home":"2","away":"4","winner":"away"},"teams":{"home":{"tid":"1540","tname":"Slavia Mozyr","logo":"https:\/\/gcdnimages.entitysport.com\/soccer\/team-s2\/3358.png","fullname":"FC Slavia Mozyr","abbr":"SLM","card":"1"},"away":{"tid":"4298","tname":"Maxline Rogachev","logo":"https:\/\/gcdnimages.entitysport.com\/soccer\/team-s2\/381792.png","fullname":"Maxline Rogachev","abbr":"MAX","card":""}},"periods":{"p1":{"home":1,"away":2},"p2":{"home":1,"away":2},"ft":{"home":2,"away":4}},"datestart":"2026-07-01 17:30:00","timestampstart":1782927000,"time":"90","status":"2"}]},{"cid":"2175","cname":"Virsliga","logo":"https:\/\/gcdnimages.entitysport.com\/soccer\/competition\/265.png","matches":[{"mid":"452074","round":"21","group":"","result":{"home":"1","away":"2","winner":"away"},"teams":{"home":{"tid":"5649","tname":"Tukums 2000","logo":"https:\/\/gcdnimages.entitysport.com\/soccer\/team-s2\/36080.png","fullname":"FK Tukums 2000\/TSS","abbr":"TUK","card":""},"away":{"tid":"16349","tname":"sk super nova","logo":"https:\/\/gcdnimages.entitysport.com\/soccer\/team-s2\/282126.png","fullname":"sk super nova","abbr":"SUN","card":""}},"periods":{"p1":{"home":1,"away":1},"p2":{"home":0,"away":1},"ft":{"home":1,"away":2}},"datestart":"2026-07-01 15:00:00","timestampstart":1782918000,"time":"90","status":"2"}]},{"cid":"2176","cname":"1 Lyga","logo":"https:\/\/gcdnimages.entitysport.com\/soccer\/competition\/273.png","matches":[{"mid":"452405","round":"1","group":"","result":{"home":"0","away":"1","winner":"away"},"teams":{"home":{"tid":"17404","tname":"atmosfera mazeikiai","logo":"https:\/\/gcdnimages.entitysport.com\/soccer\/team-s2\/254328.png","fullname":"atmosfera mazeikiai","abbr":"ATM","card":""},"away":{"tid":"15443","tname":"be1 nfa","logo":"https:\/\/gcdnimages.entitysport.com\/soccer\/team-s2\/378800.png","fullname":"be1 nfa","abbr":"BE1","card":""}},"periods":{"p1":{"home":0,"away":1},"p2":{"home":0,"away":0},"ft":{"home":0,"away":1}},"datestart":"2026-07-01 16:00:00","timestampstart":1782921600,"time":"90","status":"2"},{"mid":"452404","round":"1","group":"","result":{"home":"1","away":"3","winner":"away"},"teams":{"home":{"tid":"17925","tname":"fa siauliai b","logo":"https:\/\/gcdnimages.entitysport.com\/soccer\/team-s2\/350213.png","fullname":"fa siauliai b","abbr":"SIA","card":""},"away":{"tid":"15441","tname":"fk tauras","logo":"https:\/\/gcdnimages.entitysport.com\/soccer\/team-s2\/35389.png","fullname":"fk tauras","abbr":"TAU","card":""}},"periods":{"p1":{"home":1,"away":0},"p2":{"home":0,"away":3},"ft":{"home":1,"away":3}},"datestart":"2026-07-01 15:00:00","timestampstart":1782918000,"time":"90","status":"2"}]},{"cid":"2179","cname":"Brasileiro Serie C","logo":"https:\/\/gcdnimages.entitysport.com\/soccer\/competition\/395.png","matches":[{"mid":"453173","round":"12","group":"Brasileiro Serie C","result":{"home":"3","away":"0","winner":"home"},"teams":{"home":{"tid":"4423","tname":"Volta Redonda","logo":"https:\/\/gcdnimages.entitysport.com\/soccer\/team-s2\/6982.png","fullname":"Volta Redonda FC RJ","abbr":"VOR","card":""},"away":{"tid":"8014","tname":"Amazonas FC AM","logo":"https:\/\/gcdnimages.entitysport.com\/soccer\/team-s2\/336664.png","fullname":"Amazonas FC AM","abbr":"AMA","card":""}},"periods":{"p1":{"home":0,"away":0},"p2":{"home":3,"away":0},"ft":{"home":3,"away":0}},"datestart":"2026-06-30 23:30:00","timestampstart":1782862200,"time":"90","status":"2"},{"mid":"453172","round":"12","group":"Brasileiro Serie C","result":{"home":"2","away":"0","winner":"home"},"teams":{"home":{"tid":"14670","tname":"botafogopb","logo":"https:\/\/gcdnimages.entitysport.com\/soccer\/team-s2\/49196.png","fullname":"botafogopb","abbr":"BOT","card":""},"away":{"tid":"4469","tname":"Brusque","logo":"https:\/\/gcdnimages.entitysport.com\/soccer\/team-s2\/21884.png","fullname":"Brusque FC SC","abbr":"BRU","card":""}},"periods":{"p1":{"home":0,"away":0},"p2":{"home":2,"away":0},"ft":{"home":2,"away":0}},"datestart":"2026-06-30 23:30:00","timestampstart":1782862200,"time":"90","status":"2"},{"mid":"453171","round":"12","group":"Brasileiro Serie C","result":{"home":"1","away":"1","winner":"draw"},"teams":{"home":{"tid":"7350","tname":"Caxias do Sul","logo":"https:\/\/gcdnimages.entitysport.com\/soccer\/team-s2\/2000.png","fullname":"SER Caxias do Sul","abbr":"CAX","card":""},"away":{"tid":"8010","tname":"Anapolis FC GO","logo":"https:\/\/gcdnimages.entitysport.com\/soccer\/team-s2\/21872.png","fullname":"Anapolis FC GO","abbr":"ANA","card":""}},"periods":{"p1":{"home":0,"away":0},"p2":{"home":1,"away":1},"ft":{"home":1,"away":1}},"datestart":"2026-06-30 22:30:00","timestampstart":1782858600,"time":"90","status":"2"}]}],"total_items":7,"total_pages":1},"etag":"63d8e956eae64ce450f140cad53bac25","modified":"2026-07-06 03:39:48","datetime":"2026-07-06 03:39:48","api_version":"1.0"}
curl --location --request GET 'https://zylalabs.com/api/13052/api+football/26352/tournament+games' --header 'Authorization: Bearer YOUR_API_KEY'
{"status":"ok","response":{"items":[{"sid":"25-26","name":"25-26","competition_id":"1914"},{"sid":"24-25","name":"24-25","competition_id":"1915"},{"sid":"23-24","name":"23-24","competition_id":"1916"},{"sid":"22-23","name":"22-23","competition_id":"1952"},{"sid":"21-22","name":"21-22","competition_id":"1953"},{"sid":"20-21","name":"20-21","competition_id":"1954"}],"total_items":6,"total_pages":1},"etag":"f8db301d891dd75155a3d5c3ed3a94df","modified":"2026-07-06 03:49:57","datetime":"2026-07-06 03:49:57","api_version":"1.0"}
curl --location --request GET 'https://zylalabs.com/api/13052/api+football/26459/tournament+games+overview?tournament_id=3' --header 'Authorization: Bearer YOUR_API_KEY'
After signing up, every developer is assigned a personal API access key, a unique combination of letters and digits provided to access to our API endpoint. To authenticate with the API Football simply include your bearer token in the Authorization header.
| Header | Description |
|---|---|
Authorization
|
Required
Should be Bearer access_key. See "Your API Access Key" above when you are subscribed.
|
No long-term commitment. Upgrade, downgrade, or cancel anytime. Free Trial includes up to 50 requests.
(Save 2 months with annual billing 🎉)
Trusted by leading companies
⚽ Live Football Scores
Get instant updates from ongoing matches with lightning-fast live scores. Never miss a goal, card, or key moment again.
📊 Detailed Match Stats
Dive deep into team and player performance with comprehensive football statistics including possession, shots, lineups, head-to-head records, and more.
🗣️ Live Commentary
Follow every match with real-time text commentary. Experience the game even when you can't watch it live.
🏆 All Major Leagues Covered
Track matches from top football leagues and tournaments including Premier League, La Liga, Serie A, Bundesliga, Champions League, and more.
📅 Match Schedules & Fixtures
Stay updated with upcoming matches, fixtures, and match timings so you never miss your favorite team in action.
This endpoint returns data related to ongoing matches in various football competitions. It includes match status, teams involved, scores, and other relevant match details.
Key fields include "status," "response," "items," "total_items," "total_pages," and "datetime." The "items" array contains detailed match information, while "total_items" indicates the number of matches returned.
The response is structured in a JSON format. It contains a "status" field indicating the request outcome, a "response" object with match details, and metadata like "etag" and "api_version."
Users can customize their requests using parameters such as "per_page" (number of results per page), "paged" (page number), "timezone" (time zone for match times), and "status" (filter by match status).
This endpoint provides information on match scores, team lineups, match status, and statistics like possession and shots, allowing users to track live match developments comprehensively.
Data accuracy is maintained through partnerships with reliable sports data providers and continuous monitoring of match events to ensure real-time updates reflect actual game conditions.
Typical use cases include live score tracking, sports analytics, and providing real-time updates for sports news applications, enhancing user engagement during matches.
Users should check the "total_items" field; if it is zero, no matches are available. For partial results, they can adjust parameters like "per_page" or "paged" to refine their queries for more comprehensive data.
Users can customize requests using parameters like "per_page" to set the number of results per page, "paged" to specify the page number, "timezone" for match times, and "status" to filter matches by their current state.
The "items" array contains detailed information about each match, including teams, scores, and statistics. Each object within the array corresponds to a specific match currently being played.
The "total_pages" field indicates the total number of pages available for the results based on the current query parameters. This helps users navigate through multiple pages of match data.
Users can leverage the returned data for live score updates, sports analytics, and enhancing user engagement in applications by displaying real-time match statistics and commentary.
API Football covers major football leagues and tournaments worldwide, including the Premier League, La Liga, Serie A, Bundesliga, and the Champions League, ensuring comprehensive global coverage.
Data quality is ensured through partnerships with reputable sports data providers, continuous monitoring of match events, and rigorous validation processes to maintain accuracy and reliability.
If the response is empty, check the "total_items" field; if it shows zero, no matches are available. Adjust your parameters, such as "status" or "timezone," to refine your query for better results.
The response includes match details such as team names, current scores, match status (e.g., live, finished), match time, and statistics like possession and shots. This allows users to track the game's progress comprehensively.
You can use the "status" parameter to filter matches. Accepted values typically include "live," "finished," or "upcoming," allowing you to retrieve only the matches that meet your criteria.
The "etag" field is a unique identifier for the response data, used for caching purposes. It helps clients determine if the data has changed since the last request, optimizing data retrieval.
You can adjust the "per_page" parameter to specify the number of results you want per page. For example, setting "per_page=10" will return ten match entries in the response.
The API Football covers a wide range of leagues and competitions globally, including top leagues like the Premier League, La Liga, Serie A, Bundesliga, and international tournaments like the Champions League.
The "total_items" field indicates the total number of matches available based on your query parameters. This helps you understand the scope of the data returned and whether further filtering is needed.
The "datetime" field provides the timestamp of when the response was generated. This is useful for tracking the recency of the data and ensuring you are viewing the latest match information.
While the GET Competition Matches List endpoint primarily focuses on match data, you can integrate live commentary from the API to enhance user engagement by providing real-time updates and insights during matches.
To obtain your API key, first sign in to your account and navigate to the API you want to use. From the API's Pricing section, choose a plan and complete the subscription process. Once subscribed, return to the API page and you will see your API Access Key displayed at the top of the documentation page. You can use this key to authenticate your requests.
You can’t switch APIs during the free trial. If you subscribe to a different API, your trial will end and the new subscription will start as a paid plan.
The free trial lasts for 7 days and allows you to make up to 50 API requests.
No, the free trial is available only once, so we recommend using it on the API that interests you the most. Most of our APIs offer a free trial, but some may not include this option.
Yes. If the API offers a free trial, you will see a "Free 7-Day Trial" option in its Pricing section. The trial lasts for 7 days and allows up to 50 API requests, enabling you to evaluate the API before subscribing to a paid plan.
Zyla API Hub is like a big store for APIs, where you can find thousands of them all in one place. We also offer dedicated support and real-time monitoring of all APIs. Once you sign up, you can pick and choose which APIs you want to use. Just remember, each API needs its own subscription. But if you subscribe to multiple ones, you'll use the same key for all of them, making things easier for you.
You can monitor your API usage through the response headers included with every request:
x-zyla-api-calls-monthly-used: Shows the total number of API requests you have used during the current billing period.
x-zyla-api-calls-monthly-remaining: Shows the number of API requests you have remaining for the current billing period.
Yes, you can cancel your subscription at any time. Simply go to the Pricing section of the API you're subscribed to and click the "Unsubscribe" button.
Please note that upgrades, downgrades, and cancellations take effect immediately. Once your subscription is canceled, access to the service will end immediately, regardless of any remaining API calls in your quota.
Please have a look at our Refund Policy: https://zylalabs.com/terms#refund