OneFootball API

API ID 13509

Football matches by date, match details with lineups, statistics and events, competition standings and fixtures, team pages and squads, plus player profiles.

393 ms avg response

API Documentation

Endpoints

Request
Returns the alphabetical index of all competitions.
Endpoint ID: 29905
GET https://docs.zylalabs.com/api/13509/onefootball+api/29905/get+all+competition+letters
INPUT PARAMETERS

Free test requests remaining: 3 of 3.

This endpoint does not require any input parameters.

API EXAMPLE RESPONSE
JSON
[
    {
        "letter": "A",
        "url": "https://onefootball.com/en/all-competitions/a"
    },
    {
        "letter": "B",
        "url": "https://onefootball.com/en/all-competitions/b"
    },
    {
        "letter": "C",
        "url": "https://onefootball.com/en/all-competitions/c"
    },
    {
        "letter": "D",
        "url": "https://onefootball.com/en/all-competitions/d"
    },
    {
        "letter": "E",
        "url": "https://onefootball.com/en/all-competitions/e"
    },
    {
        "letter": "F",
        "url": "https://onefootball.com/en/all-competitions/f"
    },
    {
        "letter": "G",
        "url": "https://onefootball.com/en/all-competitions/g"
    },
    {
        "letter": "H",
        "url": "https://onefootball.com/en/all-competitions/h"
    },
    {
        "letter": "I",
        "url": "https://onefootball.com/en/all-competitions/i"
    },
    {
        "letter": "J",
        "url": "https://onefootball.com/en/all-competitions/j"
    },
    {
        "letter": "K",
        "url": "https://onefootball.com/en/all-competitions/k"
    },
    {
        "letter": "L",
        "url": "https://onefootball.com/en/all-competitions/l"
    },
    {
        "letter": "M",
        "url": "https://onefootball.com/en/all-competitions/m"
    },
    {
        "letter": "N",
        "url": "https://onefootball.com/en/all-competitions/n"
    },
    {
        "letter": "O",
        "url": "https://onefootball.com/en/all-competitions/o"
    },
    {
        "letter": "P",
        "url": "https://onefootball.com/en/all-competitions/p"
    },
    {
        "letter": "Q",
        "url": "https://onefootball.com/en/all-competitions/q"
    },
    {
        "letter": "R",
        "url": "https://onefootball.com/en/all-competitions/r"
    },
    {
        "letter": "S",
        "url": "https://onefootball.com/en/all-competitions/s"
    },
    {
        "letter": "T",
        "url": "https://onefootball.com/en/all-competitions/t"
    },
    {
        "letter": "U",
        "url": "https://onefootball.com/en/all-competitions/u"
    },
    {
        "letter": "V",
        "url": "https://onefootball.com/en/all-competitions/v"
    },
    {
        "letter": "W",
        "url": "https://onefootball.com/en/all-competitions/w"
    },
    {
        "letter": "Y",
        "url": "https://onefootball.com/en/all-competitions/y"
    }
]
Get all competition letters — CODE SNIPPETS

curl --location --request GET 'https://zylalabs.com/api/13509/onefootball+api/29905/get+all+competition+letters' --header 'Authorization: Bearer YOUR_API_KEY' 


    
Request
Returns all competitions for a letter...
Endpoint ID: 29906
GET https://docs.zylalabs.com/api/13509/onefootball+api/29906/get+competitions+by+letter
INPUT PARAMETERS

Get competitions by letter — Endpoint Features

Object Description
letter Required Single letter (a-z) the results are filtered by.

Free test requests remaining: 3 of 3.


INPUT PARAMETERS

letter
API EXAMPLE RESPONSE
JSON
[
    {
        "id": 2748,
        "name": "A Lyga",
        "url": "https://onefootball.com/en/competition/a-lyga-2748"
    },
    {
        "id": 84,
        "name": "A-League Men",
        "url": "https://onefootball.com/en/competition/a-league-men-84"
    },
    {
        "id": 2806,
        "name": "A-League Women",
        "url": "https://onefootball.com/en/competition/a-league-women-2806"
    },
    {
        "id": 3018,
        "name": "A-Leagues All Stars Game Women",
        "url": "https://onefootball.com/en/competition/a-leagues-all-stars-game-women-3018"
    },
    {
        "id": 156,
        "name": "AFC Asian Cup",
        "url": "https://onefootball.com/en/competition/afc-asian-cup-156"
    },
    {
        "id": 2797,
        "name": "AFC Asian Cup Qualifiers",
        "url": "https://onefootball.com/en/competition/afc-asian-cup-qualifiers-2797"
    },
    {
        "id": 73,
        "name": "AFC Asian Qualifiers – Road to 26",
        "url": "https://onefootball.com/en/competition/afc-asian-qualifiers-road-to-26-73"
    },
    {
        "id": 2945,
        "name": "AFC Challenge League",
        "url": "https://onefootball.com/en/competition/afc-challenge-league-2945"
    },
    {
        "id": 155,
        "name": "AFC Champions League Elite",
        "url": "https://onefootball.com/en/competition/afc-champions-league-elite-155"
    },
    {
        "id": 2760,
        "name": "AFC Champions League Two",
        "url": "https://onefootball.com/en/competition/afc-champions-league-two-2760"
    },
    {
        "id": 2997,
        "name": "AFC U-17 Asian Cup",
        "url": "https://onefootball.com/en/competition/afc-u-17-asian-cup-2997"
    },
    {
        "id": 2998,
        "name": "AFC U-17 Women's Asian Cup",
        "url": "https://onefootball.com/en/competition/afc-u-17-womens-asian-cup-2998"
    },
    {
        "id": 2996,
        "name": "AFC U-20 Women's Asian Cup",
        "url": "https://onefootball.com/en/competition/afc-u-20-womens-asian-cup-2996"
    },
    {
        "id": 2938,
        "name": "AFC U-23 Asian Cup",
        "url": "https://onefootball.com/en/competition/afc-u-23-asian-cup-2938"
    },
    {
        "id": 2783,
        "name": "AFC Women's Asian Cup",
        "url": "https://onefootball.com/en/competition/afc-womens-asian-cup-2783"
    },
    {
        "id": 2953,
        "name": "AFC Women's Champions League",
        "url": "https://onefootball.com/en/competition/afc-womens-champions-league-2953"
    },
    {
        "id": 2979,
        "name": "ASEAN Club Championship",
        "url": "https://onefootball.com/en/competition/asean-club-championship-2979"
    },
    {
        "id": 2777,
        "name": "ASEAN Hyundai Cup",
        "url": "https://onefootball.com/en/competition/asean-hyundai-cup-2777"
    },
    {
        "id": 2978,
        "name": "ASEAN Women's Championship",
        "url": "https://onefootball.com/en/competition/asean-womens-championship-2978"
    },
    {
        "id": 1877,
        "name": "Acreano",
        "url": "https://onefootball.com/en/competition/acreano-1877"
    },
    {
        "id": 2695,
        "name": "Africa Cup Of Nations Qualifiers",
        "url": "https://onefootball.com/en/competition/africa-cup-of-nations-qualifiers-2695"
    },
    {
        "id": 49,
        "name": "Africa Cup of Nations",
        "url": "https://onefootball.com/en/competition/africa-cup-of-nations-49"
    },
    {
        "id": 2822,
        "name": "Africa Women Cup of Nations",
        "url": "https://onefootball.com/en/competition/africa-women-cup-of-nations-2822"
    },
    {
        "id": 2901,
        "name": "African Football League",
        "url": "https://onefootball.com/en/competition/african-football-league-2901"
    },
    {
        "id": 2755,
        "name": "African Nations Championship",
        "url": "https://onefootball.com/en/competition/african-nations-championship-2755"
    },
    {
        "id": 1878,
        "name": "Alagoano",
        "url": "https://onefootball.com/en/competition/alagoano-1878"
    },
    {
        "id": 2957,
        "name": "Algeria Ligue 2",
        "url": "https://onefootball.com/en/competition/algeria-ligue-2-2957"
    },
    {
        "id": 62,
        "name": "Allsvenskan",
        "url": "https://onefootball.com/en/competition/allsvenskan-62"
    },
    {
        "id": 2909,
        "name": "Allsvenskan Relegation Play-off",
        "url": "https://onefootball.com/en/competition/allsvenskan-relegation-play-off-2909"
    },
    {
        "id": 1879,
        "name": "Amapaense",
        "url": "https://onefootball.com/en/competition/amapaense-1879"
    },
    {
        "id": 1880,
        "name": "Amazonense",
        "url": "https://onefootball.com/en/competition/amazonense-1880"
    },
    {
        "id": 2827,
        "name": "Arab Club Champions Cup",
        "url": "https://onefootball.com/en/competition/arab-club-champions-cup-2827"
    },
    {
        "id": 2837,
        "name": "Arabian Gulf Cup",
        "url": "https://onefootball.com/en/competition/arabian-gulf-cup-2837"
    },
    {
        "id": 2770,
        "name": "Armenian Premier League",
        "url": "https://onefootball.com/en/competition/armenian-premier-league-2770"
    },
    {
        "id": 2786,
        "name": "Arnold Clark Cup",
        "url": "https://onefootball.com/en/competition/arnold-clark-cup-2786"
    },
    {
        "id": 2722,
        "name": "Australia Cup",
        "url": "https://onefootball.com/en/competition/australia-cup-2722"
    },
    {
        "id": 26,
        "name": "Austrian Bundesliga",
        "url": "https://onefootball.com/en/competition/austrian-bundesliga-26"
    },
    {
        "id": 2771,
        "name": "Azerbaijan Premier League",
        "url": "https://onefootball.com/en/competition/azerbaijan-premier-league-2771"
    }
]
Get competitions by letter — CODE SNIPPETS

curl --location --request GET 'https://zylalabs.com/api/13509/onefootball+api/29906/get+competitions+by+letter?letter=a' --header 'Authorization: Bearer YOUR_API_KEY' 


    
Request
Returns details for a competition.......
Endpoint ID: 29907
GET https://docs.zylalabs.com/api/13509/onefootball+api/29907/get+competition+details
INPUT PARAMETERS

Get competition details — Endpoint Features

Object Description
competition_id Required Competition ID.

Free test requests remaining: 3 of 3.


INPUT PARAMETERS

competition_id
API EXAMPLE RESPONSE
JSON
{
    "id": 10,
    "name": "LaLiga",
    "image": "https://images.onefootball.com/icons/leagueColoredCompetition/128/10.png",
    "url": "https://onefootball.com/en/competition/laliga-10"
}
Get competition details — CODE SNIPPETS

curl --location --request GET 'https://zylalabs.com/api/13509/onefootball+api/29907/get+competition+details?competition_id=10' --header 'Authorization: Bearer YOUR_API_KEY' 


    
Request
Returns the fixtures for a competition..
Endpoint ID: 29908
GET https://docs.zylalabs.com/api/13509/onefootball+api/29908/get+competition+fixtures
INPUT PARAMETERS

Get competition fixtures — Endpoint Features

Object Description
competition_id Required Competition ID.

Free test requests remaining: 3 of 3.


INPUT PARAMETERS

competition_id
API EXAMPLE RESPONSE
JSON
[
    {
        "name": "Matchday 1",
        "matches": [
            {
                "id": 2700185,
                "url": "https://onefootball.com/en/match/2700185",
                "datetime": "2026-08-15T17:30:00Z",
                "timePeriod": null,
                "period": "PRE_MATCH",
                "status": {
                    "isCancelled": false,
                    "isPostponed": false,
                    "isStarted": false,
                    "isInProgress": false,
                    "isFinished": false,
                    "isFinishedAfterPenalties": false
                },
                "homeTeam": {
                    "id": 1254,
                    "name": "Alavés",
                    "image": "https://images.onefootball.com/icons/teams/164/1254.png"
                },
                "awayTeam": {
                    "id": 216,
                    "name": "Getafe",
                    "image": "https://images.onefootball.com/icons/teams/164/216.png"
                }
            },
            {
                "id": 2700193,
                "url": "https://onefootball.com/en/match/2700193",
                "datetime": "2026-08-15T19:30:00Z",
                "timePeriod": null,
                "period": "PRE_MATCH",
                "status": {
                    "isCancelled": false,
                    "isPostponed": false,
                    "isStarted": false,
                    "isInProgress": false,
                    "isFinished": false,
                    "isFinishedAfterPenalties": false
                },
                "homeTeam": {
                    "id": 28,
                    "name": "Sevilla",
                    "image": "https://images.onefootball.com/icons/teams/164/28.png"
                },
                "awayTeam": {
                    "id": 690,
                    "name": "Rayo Vallecano",
                    "image": "https://images.onefootball.com/icons/teams/164/690.png"
                }
            },
            {
                "id": 2700191,
                "url": "https://onefootball.com/en/match/2700191",
                "datetime": "2026-08-16T15:00:00Z",
                "timePeriod": null,
                "period": "PRE_MATCH",
                "status": {
                    "isCancelled": false,
                    "isPostponed": false,
                    "isStarted": false,
                    "isInProgress": false,
                    "isFinished": false,
                    "isFinishedAfterPenalties": false
                },
                "homeTeam": {
                    "id": 222,
                    "name": "Racing de Santander",
                    "image": "https://images.onefootball.com/icons/teams/164/222.png"
                },
                "awayTeam": {
                    "id": 226,
                    "name": "Villarreal",
                    "image": "https://images.onefootball.com/icons/teams/164/226.png"
                }
            },
            {
                "id": 2700189,
                "url": "https://onefootball.com/en/match/2700189",
                "datetime": "2026-08-16T17:00:00Z",
                "timePeriod": null,
                "period": "PRE_MATCH",
                "status": {
                    "isCancelled": false,
                    "isPostponed": false,
                    "isStarted": false,
                    "isInProgress": false,
                    "isFinished": false,
                    "isFinishedAfterPenalties": false
                },
                "homeTeam": {
                    "id": 215,
                    "name": "Espanyol",
                    "image": "https://images.onefootball.com/icons/teams/164/215.png"
                },
                "awayTeam": {
                    "id": 218,
                    "name": "Levante",
                    "image": "https://images.onefootball.com/icons/teams/164/218.png"
                }
            },
            {
                "id": 2700188,
                "url": "https://onefootball.com/en/match/2700188",
                "datetime": "2026-08-17T19:00:00Z",
                "timePeriod": null,
                "period": "PRE_MATCH",
                "status": {
                    "isCancelled": false,
                    "isPostponed": false,
                    "isStarted": false,
                    "isInProgress": false,
                    "isFinished": false,
                    "isFinishedAfterPenalties": false
                },
                "homeTeam": {
                    "id": 214,
                    "name": "Deportivo A Coruña",
                    "image": "https://images.onefootball.com/icons/teams/164/214.png"
                },
                "awayTeam": {
                    "id": 682,
                    "name": "Elche",
                    "image": "https://images.onefootball.com/icons/teams/164/682.png"
                }
            },
            {
                "id": 2700186,
                "url": "https://onefootball.com/en/match/2700186",
                "datetime": "2026-08-19T19:00:00Z",
                "timePeriod": null,
                "period": "PRE_MATCH",
                "status": {
                    "isCancelled": false,
                    "isPostponed": false,
                    "isStarted": false,
                    "isInProgress": false,
                    "isFinished": false,
                    "isFinishedAfterPenalties": false
                },
                "homeTeam": {
                    "id": 3,
                    "name": "Atlético de Madrid",
                    "image": "https://images.onefootball.com/icons/teams/164/3.png"
                },
                "awayTeam": {
                    "id": 219,
                    "name": "Málaga",
                    "image": "https://images.onefootball.com/icons/teams/164/219.png"
                }
            },
            {
                "id": 2700194,
                "url": "https://onefootball.com/en/match/2700194",
                "datetime": "2026-08-25T19:00:00Z",
                "timePeriod": null,
                "period": "PRE_MATCH",
                "status": {
                    "isCancelled": false,
                    "isPostponed": false,
                    "isStarted": false,
                    "isInProgress": false,
                    "isFinished": false,
                    "isFinishedAfterPenalties": false
                },
                "homeTeam": {
                    "id": 143,
                    "name": "Valencia",
                    "image": "https://images.onefootball.com/icons/teams/164/143.png"
                },
                "awayTeam": {
                    "id": 691,
                    "name": "Real Betis",
                    "image": "https://images.onefootball.com/icons/teams/164/691.png"
                }
            },
            {
                "id": 2700192,
                "url": "https://onefootball.com/en/match/2700192",
                "datetime": "2026-08-26T19:00:00Z",
                "timePeriod": null,
                "period": "PRE_MATCH",
                "status": {
                    "isCancelled": false,
                    "isPostponed": false,
                    "isStarted": false,
                    "isInProgress": false,
                    "isFinished": false,
                    "isFinishedAfterPenalties": false
                },
                "homeTeam": {
                    "id": 26,
                    "name": "Real Madrid",
                    "image": "https://images.onefootball.com/icons/teams/164/26.png"
                },
                "awayTeam": {
                    "id": 223,
                    "name": "Real Sociedad",
                    "image": "https://images.onefootball.com/icons/teams/164/223.png"
                }
            },
            {
                "id": 2700187,
                "url": "https://onefootball.com/en/match/2700187",
                "datetime": "2026-08-27T18:30:00Z",
                "timePeriod": null,
                "period": "PRE_MATCH",
                "status": {
                    "isCancelled": false,
                    "isPostponed": false,
                    "isStarted": false,
                    "isInProgress": false,
                    "isFinished": false,
                    "isFinishedAfterPenalties": false
                },
                "homeTeam": {
                    "id": 680,
                    "name": "Celta de Vigo",
                    "image": "https://images.onefootball.com/icons/teams/164/680.png"
                },
                "awayTeam": {
                    "id": 221,
                    "name": "Osasuna",
                    "image": "https://images.onefootball.com/icons/teams/164/221.png"
                }
            },
            {
                "id": 2700190,
                "url": "https://onefootball.com/en/match/2700190",
                "datetime": "2026-08-27T19:00:00Z",
                "timePeriod": null,
                "period": "PRE_MATCH",
                "status": {
                    "isCancelled": false,
                    "isPostponed": false,
                    "isStarted": false,
                    "isInProgress": false,
                    "isFinished": false,
                    "isFinishedAfterPenalties": false
                },
                "homeTeam": {
                    "id": 5
                }
            }
        ]
    },
    {
        "_note": "Response truncated for documentation purposes"
    }
]
Get competition fixtures — CODE SNIPPETS

curl --location --request GET 'https://zylalabs.com/api/13509/onefootball+api/29908/get+competition+fixtures?competition_id=10' --header 'Authorization: Bearer YOUR_API_KEY' 


    
Request
Returns the standings table for a competition. Supports single tables and multi-group tables.
Endpoint ID: 29909
GET https://docs.zylalabs.com/api/13509/onefootball+api/29909/get+competition+table
INPUT PARAMETERS

Get competition table — Endpoint Features

Object Description
competition_id Required Competition ID.

Free test requests remaining: 3 of 3.


INPUT PARAMETERS

competition_id
API EXAMPLE RESPONSE
JSON
{
    "hasGroups": false,
    "groups": [
        {
            "title": "",
            "standings": [
                {
                    "position": 1,
                    "positionChange": null,
                    "team": {
                        "id": 55,
                        "name": "Argentina",
                        "image": "https://images.onefootball.com/icons/teams/164/55.png",
                        "url": "https://onefootball.com/en/team/argentina-55"
                    },
                    "played": 18,
                    "won": 12,
                    "drawn": 2,
                    "lost": 4,
                    "goalsDiff": 21,
                    "points": 38
                },
                {
                    "position": 2,
                    "positionChange": "UP",
                    "team": {
                        "id": 101,
                        "name": "Ecuador",
                        "image": "https://images.onefootball.com/icons/teams/164/101.png",
                        "url": "https://onefootball.com/en/team/ecuador-101"
                    },
                    "played": 18,
                    "won": 8,
                    "drawn": 8,
                    "lost": 2,
                    "goalsDiff": 9,
                    "points": 29
                },
                {
                    "position": 3,
                    "positionChange": "UP",
                    "team": {
                        "id": 118,
                        "name": "Colombia",
                        "image": "https://images.onefootball.com/icons/teams/164/118.png",
                        "url": "https://onefootball.com/en/team/colombia-118"
                    },
                    "played": 18,
                    "won": 7,
                    "drawn": 7,
                    "lost": 4,
                    "goalsDiff": 10,
                    "points": 28
                },
                {
                    "position": 4,
                    "positionChange": "DOWN",
                    "team": {
                        "id": 56,
                        "name": "Uruguay",
                        "image": "https://images.onefootball.com/icons/teams/164/56.png",
                        "url": "https://onefootball.com/en/team/uruguay-56"
                    },
                    "played": 18,
                    "won": 7,
                    "drawn": 7,
                    "lost": 4,
                    "goalsDiff": 10,
                    "points": 28
                },
                {
                    "position": 5,
                    "positionChange": "DOWN",
                    "team": {
                        "id": 79,
                        "name": "Brazil",
                        "image": "https://images.onefootball.com/icons/teams/164/79.png",
                        "url": "https://onefootball.com/en/team/brazil-79"
                    },
                    "played": 18,
                    "won": 8,
                    "drawn": 4,
                    "lost": 6,
                    "goalsDiff": 7,
                    "points": 28
                },
                {
                    "position": 6,
                    "positionChange": null,
                    "team": {
                        "id": 47,
                        "name": "Paraguay",
                        "image": "https://images.onefootball.com/icons/teams/164/47.png",
                        "url": "https://onefootball.com/en/team/paraguay-47"
                    },
                    "played": 18,
                    "won": 7,
                    "drawn": 7,
                    "lost": 4,
                    "goalsDiff": 4,
                    "points": 28
                },
                {
                    "position": 7,
                    "positionChange": "UP",
                    "team": {
                        "id": 840,
                        "name": "Bolivia",
                        "image": "https://images.onefootball.com/icons/teams/164/840.png",
                        "url": "https://onefootball.com/en/team/bolivia-840"
                    },
                    "played": 18,
                    "won": 6,
                    "drawn": 2,
                    "lost": 10,
                    "goalsDiff": -18,
                    "points": 20
                },
                {
                    "position": 8,
                    "positionChange": "DOWN",
                    "team": {
                        "id": 591,
                        "name": "Venezuela",
                        "image": "https://images.onefootball.com/icons/teams/164/591.png",
                        "url": "https://onefootball.com/en/team/venezuela-591"
                    },
                    "played": 18,
                    "won": 4,
                    "drawn": 6,
                    "lost": 8,
                    "goalsDiff": -10,
                    "points": 18
                },
                {
                    "position": 9,
                    "positionChange": null,
                    "team": {
                        "id": 127,
                        "name": "Peru",
                        "image": "https://images.onefootball.com/icons/teams/164/127.png",
                        "url": "https://onefootball.com/en/team/peru-127"
                    },
                    "played": 18,
                    "won": 2,
                    "drawn": 6,
                    "lost": 10,
                    "goalsDiff": -15,
                    "points": 12
                },
                {
                    "position": 10,
                    "positionChange": null,
                    "team": {
                        "id": 35,
                        "name": "Chile",
                        "image": "https://images.onefootball.com/icons/teams/164/35.png",
                        "url": "https://onefootball.com/en/team/chile-35"
                    },
                    "played": 18,
                    "won": 2,
                    "drawn": 5,
                    "lost": 11,
                    "goalsDiff": -18,
                    "points": 11
                }
            ]
        }
    ]
}
Get competition table — CODE SNIPPETS

curl --location --request GET 'https://zylalabs.com/api/13509/onefootball+api/29909/get+competition+table?competition_id=74' --header 'Authorization: Bearer YOUR_API_KEY' 


    
Request
Returns the knockout bracket (stages with matches) for a competition.
Endpoint ID: 29910
GET https://docs.zylalabs.com/api/13509/onefootball+api/29910/get+competition+knockout+tree
INPUT PARAMETERS

Get competition knockout tree — Endpoint Features

Object Description
competition_id Required Competition ID.

Free test requests remaining: 3 of 3.


INPUT PARAMETERS

competition_id
API EXAMPLE RESPONSE
JSON
[
    {
        "title": "Round of 16",
        "matches": [
            {
                "id": 2650264,
                "datetime": "2026-07-04T17:00:00Z",
                "timePeriod": "04/07/2026",
                "period": "FULL_TIME",
                "status": {
                    "isCancelled": false,
                    "isPostponed": false,
                    "isStarted": true,
                    "isInProgress": false,
                    "isFinished": true,
                    "isFinishedAfterPenalties": false
                },
                "homeTeam": {
                    "id": 132,
                    "name": "Canada",
                    "image": "https://images.onefootball.com/icons/teams/56/132.png",
                    "score": "0"
                },
                "awayTeam": {
                    "id": 108,
                    "name": "Morocco",
                    "image": "https://images.onefootball.com/icons/teams/56/108.png",
                    "score": "3"
                },
                "url": "https://onefootball.com/en/match/2650264"
            },
            {
                "id": 2650263,
                "datetime": "2026-07-04T21:00:00Z",
                "timePeriod": "04/07/2026",
                "period": "FULL_TIME",
                "status": {
                    "isCancelled": false,
                    "isPostponed": false,
                    "isStarted": true,
                    "isInProgress": false,
                    "isFinished": true,
                    "isFinishedAfterPenalties": false
                },
                "homeTeam": {
                    "id": 47,
                    "name": "Paraguay",
                    "image": "https://images.onefootball.com/icons/teams/56/47.png",
                    "score": "0"
                },
                "awayTeam": {
                    "id": 45,
                    "name": "France",
                    "image": "https://images.onefootball.com/icons/teams/56/45.png",
                    "score": "1"
                },
                "url": "https://onefootball.com/en/match/2650263"
            },
            {
                "id": 2650267,
                "datetime": "2026-07-06T19:00:00Z",
                "timePeriod": "06/07/2026",
                "period": "FULL_TIME",
                "status": {
                    "isCancelled": false,
                    "isPostponed": false,
                    "isStarted": true,
                    "isInProgress": false,
                    "isFinished": true,
                    "isFinishedAfterPenalties": false
                },
                "homeTeam": {
                    "id": 43,
                    "name": "Portugal",
                    "image": "https://images.onefootball.com/icons/teams/56/43.png",
                    "score": "0"
                },
                "awayTeam": {
                    "id": 34,
                    "name": "Spain",
                    "image": "https://images.onefootball.com/icons/teams/56/34.png",
                    "score": "1"
                },
                "url": "https://onefootball.com/en/match/2650267"
            },
            {
                "id": 2650270,
                "datetime": "2026-07-07T00:00:00Z",
                "timePeriod": "07/07/2026",
                "period": "FULL_TIME",
                "status": {
                    "isCancelled": false,
                    "isPostponed": false,
                    "isStarted": true,
                    "isInProgress": false,
                    "isFinished": true,
                    "isFinishedAfterPenalties": false
                },
                "homeTeam": {
                    "id": 81,
                    "name": "United States",
                    "image": "https://images.onefootball.com/icons/teams/56/81.png",
                    "score": "1"
                },
                "awayTeam": {
                    "id": 116,
                    "name": "Belgium",
                    "image": "https://images.onefootball.com/icons/teams/56/116.png",
                    "score": "4"
                },
                "url": "https://onefootball.com/en/match/2650270"
            },
            {
                "id": 2650266,
                "datetime": "2026-07-05T20:00:00Z",
                "timePeriod": "05/07/2026",
                "period": "FULL_TIME",
                "status": {
                    "isCancelled": false,
                    "isPostponed": false,
                    "isStarted": true,
                    "isInProgress": false,
                    "isFinished": true,
                    "isFinishedAfterPenalties": false
                },
                "homeTeam": {
                    "id": 79,
                    "name": "Brazil",
                    "image": "https://images.onefootball.com/icons/teams/56/79.png",
                    "score": "1"
                },
                "awayTeam": {
                    "id": 115,
                    "name": "Norway",
                    "image": "https://images.onefootball.com/icons/teams/56/115.png",
                    "score": "2"
                },
                "url": "https://onefootball.com/en/match/2650266"
            },
            {
                "id": 2650268,
                "datetime": "2026-07-06T01:00:00Z",
                "timePeriod": "06/07/2026",
                "period": "FULL_TIME",
                "status": {
                    "isCancelled": false,
                    "isPostponed": false,
                    "isStarted": true,
                    "isInProgress": false,
                    "isFinished": true,
                    "isFinishedAfterPenalties": false
                },
                "homeTeam": {
                    "id": 69,
                    "name": "Mexico",
                    "image": "https://images.onefootball.com/icons/teams/56/69.png",
                    "score": "2"
                },
                "awayTeam": {
                    "id": 61,
                    "name": "England",
                    "image": "https://images.onefootball.com/icons/teams/56/61.png",
                    "score": "3"
                },
                "url": "https://onefootball.com/en/match/2650268"
            },
            {
                "id": 2650271,
                "datetime": "2026-07-07T16:00:00Z",
                "timePeriod": "07/07/2026",
                "period": "FULL_TIME",
                "status": {
                    "isCancelled": false,
                    "isPostponed": false,
                    "isStarted": true,
                    "isInProgress": false,
                    "isFinished": true,
                    "isFinishedAfterPenalties": false
                },
                "homeTeam": {
                    "id": 55,
                    "name": "Argentina",
                    "image": "https://images.onefootball.com/icons/teams/56/55.png",
                    "score": "3"
                },
                "awayTeam": {
                    "id": 590,
                    "name": "Egypt",
                    "image": "https://images.onefootball.com/icons/teams/56/590.png",
                    "score": "2"
                },
                "url": "https://onefootball.com/en/match/2650271"
            },
            {
                "id": 2650269,
                "datetime": "2026-07-07T20:00:00Z",
                "timePeriod": "07/07/2026",
                "period": "FULL_TIME_PENALTIES",
                "status": {
                    "isCancelled": false,
                    "isPostponed": false,
                    "isStarted": true,
                    "isInProgress": false,
                    "isFinished": true,
                    "isFinishedAfterPenalties": true
                },
                "homeTeam": {
                    "id": 93,
                    "name": "Switzerland",
                    "image": "https://images.onefootball.com/icons/teams/56/93.png",
                    "score": "0(4)"
                },
                "awayTeam": {
                    "id": 118,
                    "name": "Colombia",
                    "image": "https://images.onefootball.com/icons/teams/56/118.png",
                    "score": "0(3)"
                },
                "url": "https://onefootball.com/en/match/2650269"
            }
        ]
    },
    {
        "title": "Quarter-finals",
        "matches": [
            {
                "id": 2650272,
                "datetime": "2026-07-09T20:00:00Z",
                "timePeriod": "09/07/2026",
                "period": "FULL_TIME",
                "status": {
                    "isCancelled": false,
                    "isPostponed": false,
                    "isStarted": true,
                    "isInProgress": false,
                    "isFinished": true,
                    "isFinishedAfterPenalties": false
                },
                "homeTeam": {
                    "id": 45,
                    "name": "France",
                    "image": "https://images.onefootball.com/icons/teams/56/45.png",
                    "score": "2"
                },
                "awayTeam": {
                    "id": 108,
                    "name": "Morocco",
                    "image": "https://images.onefootball.com/icons/teams/56/108.png",
                    "score": "0"
                }
            }
        ]
    },
    {
        "_note": "Response truncated for documentation purposes"
    }
]
Get competition knockout tree — CODE SNIPPETS

curl --location --request GET 'https://zylalabs.com/api/13509/onefootball+api/29910/get+competition+knockout+tree?competition_id=12' --header 'Authorization: Bearer YOUR_API_KEY' 


    
Request
Returns the results for a competition...
Endpoint ID: 29911
GET https://docs.zylalabs.com/api/13509/onefootball+api/29911/get+competition+results
INPUT PARAMETERS

Get competition results — Endpoint Features

Object Description
competition_id Required Competition ID.

Free test requests remaining: 3 of 3.


INPUT PARAMETERS

competition_id
API EXAMPLE RESPONSE
JSON
[
    {
        "name": "Final",
        "matches": [
            {
                "id": 2645095,
                "url": "https://onefootball.com/en/match/2645095",
                "datetime": "2026-07-19T19:00:00Z",
                "timePeriod": "Full time",
                "period": "FULL_TIME",
                "status": {
                    "isCancelled": false,
                    "isPostponed": false,
                    "isStarted": true,
                    "isInProgress": false,
                    "isFinished": true,
                    "isFinishedAfterPenalties": false
                },
                "homeTeam": {
                    "id": 34,
                    "name": "Spain",
                    "image": "https://images.onefootball.com/icons/teams/164/34.png",
                    "score": "1"
                },
                "awayTeam": {
                    "id": 55,
                    "name": "Argentina",
                    "image": "https://images.onefootball.com/icons/teams/164/55.png",
                    "score": "0"
                }
            }
        ]
    },
    {
        "name": "Match for third place",
        "matches": [
            {
                "id": 2650276,
                "url": "https://onefootball.com/en/match/2650276",
                "datetime": "2026-07-18T21:00:00Z",
                "timePeriod": "Full time",
                "period": "FULL_TIME",
                "status": {
                    "isCancelled": false,
                    "isPostponed": false,
                    "isStarted": true,
                    "isInProgress": false,
                    "isFinished": true,
                    "isFinishedAfterPenalties": false
                },
                "homeTeam": {
                    "id": 45,
                    "name": "France",
                    "image": "https://images.onefootball.com/icons/teams/164/45.png",
                    "score": "4"
                },
                "awayTeam": {
                    "id": 61,
                    "name": "England",
                    "image": "https://images.onefootball.com/icons/teams/164/61.png",
                    "score": "6"
                }
            }
        ]
    },
    {
        "name": "Semi-finals",
        "matches": [
            {
                "id": 2645094,
                "url": "https://onefootball.com/en/match/2645094",
                "datetime": "2026-07-15T19:00:00Z",
                "timePeriod": "Full time",
                "period": "FULL_TIME",
                "status": {
                    "isCancelled": false,
                    "isPostponed": false,
                    "isStarted": true,
                    "isInProgress": false,
                    "isFinished": true,
                    "isFinishedAfterPenalties": false
                },
                "homeTeam": {
                    "id": 61,
                    "name": "England",
                    "image": "https://images.onefootball.com/icons/teams/164/61.png",
                    "score": "1"
                },
                "awayTeam": {
                    "id": 55,
                    "name": "Argentina",
                    "image": "https://images.onefootball.com/icons/teams/164/55.png",
                    "score": "2"
                }
            },
            {
                "id": 2645093,
                "url": "https://onefootball.com/en/match/2645093",
                "datetime": "2026-07-14T19:00:00Z",
                "timePeriod": "Full time",
                "period": "FULL_TIME",
                "status": {
                    "isCancelled": false,
                    "isPostponed": false,
                    "isStarted": true,
                    "isInProgress": false,
                    "isFinished": true,
                    "isFinishedAfterPenalties": false
                },
                "homeTeam": {
                    "id": 45,
                    "name": "France",
                    "image": "https://images.onefootball.com/icons/teams/164/45.png",
                    "score": "0"
                },
                "awayTeam": {
                    "id": 34,
                    "name": "Spain",
                    "image": "https://images.onefootball.com/icons/teams/164/34.png",
                    "score": "2"
                }
            }
        ]
    },
    {
        "name": "Quarter-finals",
        "matches": [
            {
                "id": 2650275,
                "url": "https://onefootball.com/en/match/2650275",
                "datetime": "2026-07-12T01:00:00Z",
                "timePeriod": "Full time",
                "period": "FULL_TIME",
                "status": {
                    "isCancelled": false,
                    "isPostponed": false,
                    "isStarted": true,
                    "isInProgress": false,
                    "isFinished": true,
                    "isFinishedAfterPenalties": false
                },
                "homeTeam": {
                    "id": 55,
                    "name": "Argentina",
                    "image": "https://images.onefootball.com/icons/teams/164/55.png",
                    "score": "3"
                },
                "awayTeam": {
                    "id": 93,
                    "name": "Switzerland",
                    "image": "https://images.onefootball.com/icons/teams/164/93.png",
                    "score": "1"
                }
            },
            {
                "id": 2650274,
                "url": "https://onefootball.com/en/match/2650274",
                "datetime": "2026-07-11T21:00:00Z",
                "timePeriod": "Full time",
                "period": "FULL_TIME",
                "status": {
                    "isCancelled": false,
                    "isPostponed": false,
                    "isStarted": true,
                    "isInProgress": false,
                    "isFinished": true,
                    "isFinishedAfterPenalties": false
                },
                "homeTeam": {
                    "id": 115,
                    "name": "Norway",
                    "image": "https://images.onefootball.com/icons/teams/164/115.png",
                    "score": "1"
                },
                "awayTeam": {
                    "id": 61,
                    "name": "England",
                    "image": "https://images.onefootball.com/icons/teams/164/61.png",
                    "score": "2"
                }
            },
            {
                "id": 2650273,
                "url": "https://onefootball.com/en/match/2650273",
                "datetime": "2026-07-10T19:00:00Z",
                "timePeriod": "Full time",
                "period": "FULL_TIME",
                "status": {
                    "isCancelled": false,
                    "isPostponed": false,
                    "isStarted": true,
                    "isInProgress": false,
                    "isFinished": true,
                    "isFinishedAfterPenalties": false
                },
                "homeTeam": {
                    "id": 34,
                    "name": "Spain",
                    "image": "https://images.onefootball.com/icons/teams/164/34.png",
                    "score": "2"
                },
                "awayTeam": {
                    "id": 116,
                    "name": "Belgium",
                    "image": "https://images.onefootball.com/icons/teams/164/116.png",
                    "score": "1"
                }
            },
            {
                "id": 2650272,
                "url": "https://onefootball.com/en/match/2650272",
                "datetime": "2026-07-09T20:00:00Z",
                "timePeriod": "Full time",
                "period": "FULL_TIME",
                "status": {
                    "isCancelled": false,
                    "isPostponed": false,
                    "isStarted": true,
                    "isInProgress": false,
                    "isFinished": true,
                    "isFinishedAfterPenalties": false
                },
                "homeTeam": {
                    "id": 45,
                    "name": "France",
                    "image": "https://images.onefootball.com/icons/teams/164/45.png",
                    "score": "2"
                },
                "awayTeam": {
                    "id": 108,
                    "name": "Morocco",
                    "image": "https://images.onefootball.com/icons/teams/164/108.png",
                    "score": "0"
                }
            }
        ]
    },
    {
        "name": "Round of 16",
        "matches": [
            {
                "id": 2650269,
                "url": "https://onefootball.com/en/match/2650269",
                "datetime": "2026-07-07T20:00:00Z",
                "timePeriod": "Full time",
                "period": "FULL_TIME_PENALTIES",
                "status": {
                    "isCancelled": false,
                    "isPostponed": false,
                    "isStarted": true,
                    "isInProgress": false,
                    "isFinished": true,
                    "isFinishedAfterPenalties": true
                },
                "homeTeam": {
                    "id": 93,
                    "name": "Switzerland",
                    "image": "https://images.onefootball.com/icons/teams/164/93.png"
                }
            }
        ]
    },
    {
        "_note": "Response truncated for documentation purposes"
    }
]
Get competition results — CODE SNIPPETS

curl --location --request GET 'https://zylalabs.com/api/13509/onefootball+api/29911/get+competition+results?competition_id=12' --header 'Authorization: Bearer YOUR_API_KEY' 


    
Request
Returns the transfers for a competition.
Endpoint ID: 29912
GET https://docs.zylalabs.com/api/13509/onefootball+api/29912/get+competition+transfers
INPUT PARAMETERS

Get competition transfers — Endpoint Features

Object Description
competition_id Required Competition ID.

Free test requests remaining: 3 of 3.


INPUT PARAMETERS

competition_id
API EXAMPLE RESPONSE
JSON
[
    {
        "id": "43267726",
        "status": "DONE DEAL",
        "url": "https://onefootball.com/en/transfers/43267726",
        "player": {
            "id": 545067,
            "name": "Rockson Yeboah",
            "position": "Defender",
            "image": "https://images.onefootball.com/players/180/545067.jpg"
        },
        "transferDatetime": "2026-08-12T19:30:57Z",
        "price": "€3,000,000.00",
        "teamOld": {
            "name": "IFK Göteborg"
        },
        "teamNew": {
            "id": 221,
            "name": "Osasuna",
            "image": "https://images.onefootball.com/icons/teams/164/221.png"
        }
    },
    {
        "id": "43267230",
        "status": "DONE DEAL",
        "url": "https://onefootball.com/en/transfers/43267230",
        "player": {
            "id": 477068,
            "name": "Nobel Mendy",
            "position": "Defender",
            "image": "https://images.onefootball.com/players/180/477068.jpg"
        },
        "transferDatetime": "2026-08-12T17:36:57Z",
        "price": "€25,000,000.00",
        "teamOld": {
            "name": "Rayo Vallecano"
        },
        "teamNew": {
            "id": 276,
            "name": "Hull City",
            "image": "https://images.onefootball.com/icons/teams/164/276.png"
        }
    },
    {
        "id": "43265860",
        "status": "DONE DEAL",
        "url": "https://onefootball.com/en/transfers/43265860",
        "player": {
            "id": 262743,
            "name": "Federico Gattoni",
            "position": "Defender",
            "image": "https://images.onefootball.com/players/180/262743.jpg"
        },
        "transferDatetime": "2026-08-12T12:57:57Z",
        "price": null,
        "teamOld": {
            "name": "Sevilla"
        },
        "teamNew": {
            "id": 725,
            "name": "Ascoli",
            "image": "https://images.onefootball.com/icons/teams/164/725.png"
        }
    },
    {
        "id": "43265079",
        "status": "DONE DEAL",
        "url": "https://onefootball.com/en/transfers/43265079",
        "player": {
            "id": 175818,
            "name": "Nahuel Molina",
            "position": "Defender",
            "image": "https://images.onefootball.com/players/180/175818.jpg"
        },
        "transferDatetime": "2026-08-12T10:12:57Z",
        "price": "€18,000,000.00",
        "teamOld": {
            "name": "Atlético de Madrid"
        },
        "teamNew": {
            "id": 145,
            "name": "Roma",
            "image": "https://images.onefootball.com/icons/teams/164/145.png"
        }
    },
    {
        "id": "43264849",
        "status": "DONE DEAL",
        "url": "https://onefootball.com/en/transfers/43264849",
        "player": {
            "id": 285889,
            "name": "Pep Chavarria",
            "position": "Defender",
            "image": "https://images.onefootball.com/players/180/285889.jpg"
        },
        "transferDatetime": "2026-08-12T09:27:57Z",
        "price": "€19,000,000.00",
        "teamOld": {
            "name": "Rayo Vallecano"
        },
        "teamNew": {
            "id": 9,
            "name": "Chelsea",
            "image": "https://images.onefootball.com/icons/teams/164/9.png"
        }
    },
    {
        "id": "43262206",
        "status": "DONE DEAL",
        "url": "https://onefootball.com/en/transfers/43262206",
        "player": {
            "id": 481208,
            "name": "Thiago Fernández",
            "position": "Forward",
            "image": "https://images.onefootball.com/players/180/481208.jpg"
        },
        "transferDatetime": "2026-08-11T17:45:57Z",
        "price": "LOAN",
        "teamOld": {
            "name": "Villarreal"
        },
        "teamNew": {
            "id": 218,
            "name": "Levante",
            "image": "https://images.onefootball.com/icons/teams/164/218.png"
        }
    },
    {
        "id": "43259968",
        "status": "DONE DEAL",
        "url": "https://onefootball.com/en/transfers/43259968",
        "player": {
            "id": 384138,
            "name": "Robbie Ure",
            "position": "Forward",
            "image": "https://images.onefootball.com/players/180/384138.jpg"
        },
        "transferDatetime": "2026-08-11T10:36:57Z",
        "price": null,
        "teamOld": {
            "name": "Sirius"
        },
        "teamNew": {
            "id": 28,
            "name": "Sevilla",
            "image": "https://images.onefootball.com/icons/teams/164/28.png"
        }
    },
    {
        "id": "43259427",
        "status": "DONE DEAL",
        "url": "https://onefootball.com/en/transfers/43259427",
        "player": {
            "id": 407647,
            "name": "Carlos Dominguez Caceres",
            "position": "Defender",
            "image": "https://images.onefootball.com/players/180/407647.jpg"
        },
        "transferDatetime": "2026-08-11T08:39:57Z",
        "price": "LOAN",
        "teamOld": {
            "name": "Celta de Vigo"
        },
        "teamNew": {
            "id": 1239,
            "name": "Real Oviedo",
            "image": "https://images.onefootball.com/icons/teams/164/1239.png"
        }
    },
    {
        "id": "43257171",
        "status": "DONE DEAL",
        "url": "https://onefootball.com/en/transfers/43257171",
        "player": {
            "id": 250203,
            "name": "Ronald Araújo",
            "position": "Defender",
            "image": "https://images.onefootball.com/players/180/250203.jpg"
        },
        "transferDatetime": "2026-08-10T17:43:00Z",
        "price": "LOAN",
        "teamOld": {
            "name": "Barcelona"
        },
        "teamNew": {
            "id": 18,
            "name": "Liverpool FC",
            "image": "https://images.onefootball.com/icons/teams/164/18.png"
        }
    },
    {
        "id": "43256657",
        "status": "DONE DEAL",
        "url": "https://onefootball.com/en/transfers/43256657",
        "player": {
            "id": 428493,
            "name": "Alberto Flores Lopez",
            "position": "Goalkeeper",
            "image": "https://images.onefootball.com/players/180/428493.jpg"
        },
        "transferDatetime": "2026-08-10T16:03:57Z",
        "price": "FREE",
        "teamOld": {
            "name": "Sevilla"
        },
        "teamNew": {
            "id": 686,
            "name": "Granada",
            "image": "https://images.onefootball.com/icons/teams/164/686.png"
        }
    },
    {
        "id": "43250844",
        "status": "DONE DEAL",
        "url": "https://onefootball.com/en/transfers/43250844",
        "player": {
            "id": 266348,
            "name": "Thiago Almada",
            "position": "Midfielder",
            "image": "https://images.onefootball.com/players/180/266348.jpg"
        },
        "transferDatetime": "2026-08-09T09:51:57Z",
        "price": "€20,000,000.00",
        "teamOld": {
            "name": "Atlético de Madrid"
        },
        "teamNew": {
            "id": 1829,
            "name": "Club Atlético River Plate",
            "image": "https://images.onefootball.com/icons/teams/164/1829.png"
        }
    },
    {
        "id": "43250809",
        "status": "DONE DEAL",
        "url": "https://onefootball.com/en/transfers/43250809",
        "player": {
            "id": 482641,
            "name": "Mario Domínguez",
            "position": "Forward",
            "image": "https://images.onefootball.com/players/180/482641.jpg"
        },
        "transferDatetime": "2026-08-09T09:40:01Z",
        "price": "LOAN",
        "teamOld": {
            "name": "Valencia"
        },
        "teamNew": {
            "id": 2025,
            "name": "Excelsior",
            "image": "https://images.onefootball.com/icons/teams/164/2025.png"
        }
    },
    {
        "id": "43246203",
        "status": "DONE DEAL",
        "url": "https://onefootball.com/en/transfers/43246203",
        "player": {
            "id": 214342,
            "name": "Orel Mangala",
            "position": "Midfielder",
            "image": "https://images.onefootball.com/players/180/214342.jpg"
        },
        "transferDatetime": "2026-08-08T08:34:01Z",
        "price": "LOAN",
        "teamOld": {
            "name": "Lyon"
        },
        "teamNew": {
            "id": 216,
            "name": "Getafe",
            "image": "https://images.onefootball.com/icons/teams/164/216.png"
        }
    },
    {
        "id": "43245103",
        "status": "DONE DEAL",
        "url": "https://onefootball.com/en/transfers/43245103",
        "player": {
            "id": 412550,
            "name": "Álex Forés",
            "position": "Forward",
            "image": "https://images.onefootball.com/players/180/412550.jpg"
        },
        "transferDatetime": "2026-08-07T21:18:57Z",
        "price": null,
        "teamOld": {
            "name": "Villarreal"
        },
        "teamNew": {
            "id": 2051,
            "name": "Burgos",
            "image": "https://images.onefootball.com/icons/teams/164/2051.png"
        }
    },
    {
        "id": "43245098",
        "status": "DONE DEAL",
        "url": "https://onefootball.com/en/transfers/43245098",
        "player": {
            "id": 431005,
            "name": "Facundo Buonanotte",
            "position": "Midfielder"
        }
    },
    {
        "_note": "Response truncated for documentation purposes"
    }
]
Get competition transfers — CODE SNIPPETS

curl --location --request GET 'https://zylalabs.com/api/13509/onefootball+api/29912/get+competition+transfers?competition_id=10' --header 'Authorization: Bearer YOUR_API_KEY' 


    
Request
Returns the matches for a date, grouped by competition. Defaults to today.
Endpoint ID: 29913
GET https://docs.zylalabs.com/api/13509/onefootball+api/29913/get+matches+by+date
INPUT PARAMETERS

Get matches by date — Endpoint Features

Object Description
date Required Date in Y-m-d format.

Free test requests remaining: 3 of 3.


INPUT PARAMETERS

date
API EXAMPLE RESPONSE
JSON
[
    {
        "competition": {
            "id": 41,
            "name": "EFL Cup",
            "round": "First round",
            "image": "https://images.onefootball.com/icons/leagueColoredCompetition/128/41.png",
            "url": "https://onefootball.com/en/competition/efl-cup-41"
        },
        "matches": [
            {
                "id": 2698439,
                "url": "https://onefootball.com/en/match/2698439",
                "datetime": "2026-08-10T19:00:00Z",
                "timePeriod": "Full time",
                "period": "FULL_TIME",
                "status": {
                    "isCancelled": false,
                    "isPostponed": false,
                    "isStarted": true,
                    "isInProgress": false,
                    "isFinished": true,
                    "isFinishedAfterPenalties": false
                },
                "homeTeam": {
                    "id": 637,
                    "name": "Plymouth Argyle",
                    "image": "https://images.onefootball.com/icons/teams/164/637.png",
                    "score": "2"
                },
                "awayTeam": {
                    "id": 598,
                    "name": "Exeter City",
                    "image": "https://images.onefootball.com/icons/teams/164/598.png",
                    "score": "0"
                }
            }
        ]
    },
    {
        "competition": {
            "id": 132,
            "name": "1 Liga",
            "round": "Matchday 3",
            "image": "https://images.onefootball.com/icons/leagueColoredCompetition/128/132.png",
            "url": "https://onefootball.com/en/competition/1-liga-132"
        },
        "matches": [
            {
                "id": 2693983,
                "url": "https://onefootball.com/en/match/2693983",
                "datetime": "2026-08-10T17:00:00Z",
                "timePeriod": "Full time",
                "period": "FULL_TIME",
                "status": {
                    "isCancelled": false,
                    "isPostponed": false,
                    "isStarted": true,
                    "isInProgress": false,
                    "isFinished": true,
                    "isFinishedAfterPenalties": false
                },
                "homeTeam": {
                    "id": 16021,
                    "name": "Unia Skierniewice",
                    "image": "https://images.onefootball.com/icons/teams/164/16021.png",
                    "score": "2"
                },
                "awayTeam": {
                    "id": 2212,
                    "name": "Arka Gdynia",
                    "image": "https://images.onefootball.com/icons/teams/164/2212.png",
                    "score": "0"
                }
            }
        ]
    },
    {
        "competition": {
            "id": 121,
            "name": "1. Lig",
            "round": "Matchday 1",
            "image": "https://images.onefootball.com/icons/leagueColoredCompetition/128/121.png",
            "url": "https://onefootball.com/en/competition/1-lig-121"
        },
        "matches": [
            {
                "id": 2710317,
                "url": "https://onefootball.com/en/match/2710317",
                "datetime": "2026-08-10T18:30:00Z",
                "timePeriod": "Full time",
                "period": "FULL_TIME",
                "status": {
                    "isCancelled": false,
                    "isPostponed": false,
                    "isStarted": true,
                    "isInProgress": false,
                    "isFinished": true,
                    "isFinishedAfterPenalties": false
                },
                "homeTeam": {
                    "id": 1771,
                    "name": "Pendikspor",
                    "image": "https://images.onefootball.com/icons/teams/164/1771.png",
                    "score": "2"
                },
                "awayTeam": {
                    "id": 3951,
                    "name": "Batman Petrol",
                    "image": "https://images.onefootball.com/icons/teams/164/3951.png",
                    "score": "2"
                }
            }
        ]
    },
    {
        "competition": {
            "id": 2728,
            "name": "1. SNL",
            "round": "Matchday 4",
            "image": "https://images.onefootball.com/icons/leagueColoredCompetition/128/2728.png",
            "url": "https://onefootball.com/en/competition/1-snl-2728"
        },
        "matches": [
            {
                "id": 2694350,
                "url": "https://onefootball.com/en/match/2694350",
                "datetime": "2026-08-10T16:00:00Z",
                "timePeriod": "Full time",
                "period": "FULL_TIME",
                "status": {
                    "isCancelled": false,
                    "isPostponed": false,
                    "isStarted": true,
                    "isInProgress": false,
                    "isFinished": true,
                    "isFinishedAfterPenalties": false
                },
                "homeTeam": {
                    "id": 13557,
                    "name": "Mura",
                    "image": "https://images.onefootball.com/icons/teams/164/13557.png",
                    "score": "1"
                },
                "awayTeam": {
                    "id": 4290,
                    "name": "Radomlje",
                    "image": "https://images.onefootball.com/icons/teams/164/4290.png",
                    "score": "3"
                }
            }
        ]
    },
    {
        "competition": {
            "id": 2985,
            "name": "1. divisjon",
            "round": "Matchday 17",
            "image": "https://images.onefootball.com/icons/leagueColoredCompetition/128/2985.png",
            "url": "https://onefootball.com/en/competition/1-divisjon-2985"
        },
        "matches": [
            {
                "id": 2655585,
                "url": "https://onefootball.com/en/match/2655585",
                "datetime": "2026-08-10T17:00:00Z",
                "timePeriod": "Full time",
                "period": "FULL_TIME",
                "status": {
                    "isCancelled": false,
                    "isPostponed": false,
                    "isStarted": true,
                    "isInProgress": false,
                    "isFinished": true,
                    "isFinishedAfterPenalties": false
                },
                "homeTeam": {
                    "id": 4974,
                    "name": "Moss",
                    "image": "https://images.onefootball.com/icons/teams/164/4974.png",
                    "score": "3"
                },
                "awayTeam": {
                    "id": 1329,
                    "name": "Odd",
                    "image": "https://images.onefootball.com/icons/teams/164/1329.png",
                    "score": "3"
                }
            }
        ]
    },
    {
        "competition": {
            "id": 2748,
            "name": "A Lyga",
            "round": "Matchday 27",
            "image": "https://images.onefootball.com/icons/leagueColoredCompetition/128/2748.png",
            "url": "https://onefootball.com/en/competition/a-lyga-2748"
        },
        "matches": [
            {
                "id": 2684526,
                "url": "https://onefootball.com/en/match/2684526",
                "datetime": "2026-08-10T15:45:00Z",
                "timePeriod": "Full time",
                "period": "FULL_TIME",
                "status": {
                    "isCancelled": false,
                    "isPostponed": false,
                    "isStarted": true,
                    "isInProgress": false,
                    "isFinished": true,
                    "isFinishedAfterPenalties": false
                },
                "homeTeam": {
                    "id": 22893,
                    "name": "TransINVEST",
                    "image": "https://images.onefootball.com/icons/teams/164/22893.png",
                    "score": "0"
                },
                "awayTeam": {
                    "id": 54258,
                    "name": "Panevėžys",
                    "image": "https://images.onefootball.com/icons/teams/164/54258.png",
                    "score": "2"
                }
            },
            {
                "id": 2684527,
                "url": "https://onefootball.com/en/match/2684527",
                "datetime": "2026-08-10T16:30:00Z",
                "timePeriod": "Abandoned",
                "period": "ABANDONED",
                "status": {
                    "isCancelled": true,
                    "isPostponed": false,
                    "isStarted": true,
                    "isInProgress": false,
                    "isFinished": false,
                    "isFinishedAfterPenalties": false
                },
                "homeTeam": {
                    "id": 5198,
                    "name": "Riteriai",
                    "image": "https://images.onefootball.com/icons/teams/164/5198.png",
                    "score": "0"
                },
                "awayTeam": {
                    "id": 1065,
                    "name": "Žalgiris",
                    "image": "https://images.onefootball.com/icons/teams/164/1065.png",
                    "score": "0"
                }
            }
        ]
    },
    {
        "competition": {
            "id": 62
        }
    },
    {
        "_note": "Response truncated for documentation purposes"
    }
]
Get matches by date — CODE SNIPPETS

curl --location --request GET 'https://zylalabs.com/api/13509/onefootball+api/29913/get+matches+by+date?date=2026-08-10' --header 'Authorization: Bearer YOUR_API_KEY' 


    
Request
Returns the currently live matches, grouped by competition.
Endpoint ID: 29914
GET https://docs.zylalabs.com/api/13509/onefootball+api/29914/get+live+matches
INPUT PARAMETERS

Free test requests remaining: 3 of 3.

This endpoint does not require any input parameters.

API EXAMPLE RESPONSE
JSON
[
    {
        "competition": {
            "id": 2762,
            "name": "UEFA Conference League",
            "round": "Round 3 second leg",
            "image": "https://images.onefootball.com/icons/leagueColoredCompetition/128/2762.png",
            "url": "https://onefootball.com/en/competition/uefa-conference-league-2762"
        },
        "matches": [
            {
                "id": 2714850,
                "url": "https://onefootball.com/en/match/2714850",
                "datetime": "2026-08-13T15:00:00Z",
                "timePeriod": "0'",
                "period": "FIRST_HALF",
                "status": {
                    "isCancelled": false,
                    "isPostponed": false,
                    "isStarted": true,
                    "isInProgress": true,
                    "isFinished": false,
                    "isFinishedAfterPenalties": false
                },
                "homeTeam": {
                    "id": 536,
                    "name": "Tobol",
                    "image": "https://images.onefootball.com/icons/teams/164/536.png",
                    "score": "0"
                },
                "awayTeam": {
                    "id": 354,
                    "name": "Partizan",
                    "image": "https://images.onefootball.com/icons/teams/164/354.png",
                    "score": "0"
                }
            }
        ]
    }
]
Get live matches — CODE SNIPPETS

curl --location --request GET 'https://zylalabs.com/api/13509/onefootball+api/29914/get+live+matches' --header 'Authorization: Bearer YOUR_API_KEY' 


    
Request
Returns details for a match from OneFootball
Endpoint ID: 29915
GET https://docs.zylalabs.com/api/13509/onefootball+api/29915/get+match+details
INPUT PARAMETERS

Get match details — Endpoint Features

Object Description
match_id Required ID of the match.

Free test requests remaining: 3 of 3.


INPUT PARAMETERS

match_id
API EXAMPLE RESPONSE
JSON
{
    "id": 2650258,
    "competition": {
        "id": 12,
        "name": "FIFA World Cup™",
        "image": "https://images.onefootball.com/icons/leagueColoredCompetition/128/12.png",
        "url": "https://onefootball.com/en/competition/fifa-world-cup-12"
    },
    "datetime": "2026-07-02T00:00:00Z",
    "timePeriod": "Full time",
    "period": "FULL_TIME",
    "status": {
        "isCancelled": false,
        "isPostponed": false,
        "isStarted": true,
        "isInProgress": false,
        "isFinished": true,
        "isFinishedAfterPenalties": false
    },
    "homeTeam": {
        "id": 81,
        "name": "United States",
        "image": "https://images.onefootball.com/icons/teams/164/81.png",
        "score": "2",
        "url": "https://onefootball.com/en/team/united-states-81"
    },
    "awayTeam": {
        "id": 297,
        "name": "Bosnia & Herzegovina",
        "image": "https://images.onefootball.com/icons/teams/164/297.png",
        "score": "0",
        "url": "https://onefootball.com/en/team/bosnia-herzegovina-297"
    },
    "info": [
        {
            "title": "Competition",
            "value": "FIFA World Cup™"
        },
        {
            "title": "Kick-off",
            "value": "Yesterday"
        },
        {
            "title": "Stadium",
            "value": "San Francisco Bay Area Stadium"
        },
        {
            "title": "TV guide",
            "value": "MagentaTV"
        }
    ]
}
Get match details — CODE SNIPPETS

curl --location --request GET 'https://zylalabs.com/api/13509/onefootball+api/29915/get+match+details?match_id=2650258' --header 'Authorization: Bearer YOUR_API_KEY' 


    
Request
Returns the events (goals, cards, substitutions) for a match.
Endpoint ID: 29916
GET https://docs.zylalabs.com/api/13509/onefootball+api/29916/get+match+events
INPUT PARAMETERS

Get match events — Endpoint Features

Object Description
match_id Required ID of the match.

Free test requests remaining: 3 of 3.


INPUT PARAMETERS

match_id
API EXAMPLE RESPONSE
JSON
[
    {
        "minute": "45'",
        "type": "Goal",
        "team": "home",
        "player": "Folarin Balogun",
        "playerIn": null,
        "playerOut": null
    },
    {
        "minute": "51'",
        "type": "Substitution",
        "team": "away",
        "player": null,
        "playerIn": "Esmir Bajraktarević",
        "playerOut": "Armin Gigovic"
    },
    {
        "minute": "51'",
        "type": "Substitution",
        "team": "away",
        "player": null,
        "playerIn": "Benjamin Tahirović",
        "playerOut": "Ivan Sunjic"
    },
    {
        "minute": "51'",
        "type": "Substitution",
        "team": "away",
        "player": null,
        "playerIn": "Ermin Mahmić",
        "playerOut": "Edin Dzeko"
    },
    {
        "minute": "64'",
        "type": "Red card",
        "team": "home",
        "player": "Folarin Balogun",
        "playerIn": null,
        "playerOut": null
    },
    {
        "minute": "75'",
        "type": "Substitution",
        "team": "away",
        "player": null,
        "playerIn": "Haris Tabakovic",
        "playerOut": "Sead Kolasinac"
    },
    {
        "minute": "75'",
        "type": "Substitution",
        "team": "away",
        "player": null,
        "playerIn": "Amar Memić",
        "playerOut": "Nikola Katic"
    },
    {
        "minute": "80'",
        "type": "Yellow card",
        "team": "away",
        "player": "Stjepan Radeljic",
        "playerIn": null,
        "playerOut": null
    },
    {
        "minute": "80'",
        "type": "Yellow card",
        "team": "away",
        "player": "Player 0",
        "playerIn": null,
        "playerOut": null
    },
    {
        "minute": "82'",
        "type": "Goal",
        "team": "home",
        "player": "Malik Tillman",
        "playerIn": null,
        "playerOut": null
    },
    {
        "minute": "87'",
        "type": "Substitution",
        "team": "home",
        "player": null,
        "playerIn": "Sebastian Berhalter",
        "playerOut": "Sergiño Dest"
    },
    {
        "minute": "88'",
        "type": "Substitution",
        "team": "home",
        "player": null,
        "playerIn": "Ricardo Pepi",
        "playerOut": "Christian Pulisic"
    },
    {
        "minute": "95'",
        "type": "Substitution",
        "team": "home",
        "player": null,
        "playerIn": "Giovanni Reyna",
        "playerOut": "Weston McKennie"
    }
]
Get match events — CODE SNIPPETS

curl --location --request GET 'https://zylalabs.com/api/13509/onefootball+api/29916/get+match+events?match_id=2650258' --header 'Authorization: Bearer YOUR_API_KEY' 


    
Request
Returns the line-ups for a match........
Endpoint ID: 29917
GET https://docs.zylalabs.com/api/13509/onefootball+api/29917/get+match+lineup
INPUT PARAMETERS

Get match lineup — Endpoint Features

Object Description
match_id Required ID of the match.

Free test requests remaining: 3 of 3.


INPUT PARAMETERS

match_id
API EXAMPLE RESPONSE
JSON
{
    "title": "LINE-UPS (CONFIRMED)",
    "homeTeam": {
        "name": "United States",
        "players": [
            {
                "id": 165454,
                "name": "Christian Pulisic",
                "number": 10,
                "image": "https://images.onefootball.com/players/180/165454.jpg",
                "url": "https://onefootball.com/en/player/christian-pulisic-165454"
            },
            {
                "id": 257487,
                "name": "Folarin Balogun",
                "number": 20,
                "image": "https://images.onefootball.com/players/180/257487.jpg",
                "url": "https://onefootball.com/en/player/folarin-balogun-257487"
            },
            {
                "id": 250700,
                "name": "Sergiño Dest",
                "number": 2,
                "image": "https://images.onefootball.com/players/180/250700.jpg",
                "url": "https://onefootball.com/en/player/sergino-dest-250700"
            },
            {
                "id": 313239,
                "name": "Malik Tillman",
                "number": 17,
                "image": "https://images.onefootball.com/players/180/313239.jpg",
                "url": "https://onefootball.com/en/player/malik-tillman-313239"
            },
            {
                "id": 139813,
                "name": "Tyler Adams",
                "number": 4,
                "image": "https://images.onefootball.com/players/180/139813.jpg",
                "url": "https://onefootball.com/en/player/tyler-adams-139813"
            },
            {
                "id": 208265,
                "name": "Weston McKennie",
                "number": 8,
                "image": "https://images.onefootball.com/players/180/208265.jpg",
                "url": "https://onefootball.com/en/player/weston-mckennie-208265"
            },
            {
                "id": 145799,
                "name": "Antonee Robinson",
                "number": 5,
                "image": "https://images.onefootball.com/players/180/145799.jpg",
                "url": "https://onefootball.com/en/player/antonee-robinson-145799"
            },
            {
                "id": 19137,
                "name": "Tim Ream",
                "number": 13,
                "image": "https://images.onefootball.com/players/180/19137.jpg",
                "url": "https://onefootball.com/en/player/tim-ream-19137"
            },
            {
                "id": 254656,
                "name": "Chris Richards",
                "number": 3,
                "image": "https://images.onefootball.com/players/180/254656.jpg",
                "url": "https://onefootball.com/en/player/chris-richards-254656"
            },
            {
                "id": 474016,
                "name": "Alex Freeman",
                "number": 16,
                "image": "https://images.onefootball.com/players/180/474016.jpg",
                "url": "https://onefootball.com/en/player/alex-freeman-474016"
            },
            {
                "id": 310744,
                "name": "Matt Freese",
                "number": 24,
                "image": "https://images.onefootball.com/players/180/310744.jpg",
                "url": "https://onefootball.com/en/player/matt-freese-310744"
            }
        ]
    },
    "awayTeam": {
        "name": "Bosnia & Herzegovina",
        "players": [
            {
                "id": 219481,
                "name": "Ermedin Demirovic",
                "number": 10,
                "image": "https://images.onefootball.com/players/180/219481.jpg",
                "url": "https://onefootball.com/en/player/ermedin-demirovic-219481"
            },
            {
                "id": 1002,
                "name": "Edin Dzeko",
                "number": 11,
                "image": "https://images.onefootball.com/players/180/1002.jpg",
                "url": "https://onefootball.com/en/player/edin-dzeko-1002"
            },
            {
                "id": 514224,
                "name": "Kerim Alajbegović",
                "number": 19,
                "image": "https://images.onefootball.com/players/180/514224.jpg",
                "url": "https://onefootball.com/en/player/kerim-alajbegovic-514224"
            },
            {
                "id": 170086,
                "name": "Ivan Sunjic",
                "number": 14,
                "image": "https://images.onefootball.com/players/180/170086.jpg",
                "url": "https://onefootball.com/en/player/ivan-sunjic-170086"
            },
            {
                "id": 317445,
                "name": "Armin Gigovic",
                "number": 8,
                "image": "https://images.onefootball.com/players/180/317445.jpg",
                "url": "https://onefootball.com/en/player/armin-gigovic-317445"
            },
            {
                "id": 24865,
                "name": "Sead Kolasinac",
                "number": 5,
                "image": "https://images.onefootball.com/players/180/24865.jpg",
                "url": "https://onefootball.com/en/player/sead-kolasinac-24865"
            },
            {
                "id": 183272,
                "name": "Stjepan Radeljic",
                "number": 21,
                "image": "https://images.onefootball.com/players/180/183272.jpg",
                "url": "https://onefootball.com/en/player/stjepan-radeljic-183272"
            },
            {
                "id": 398106,
                "name": "Tarik Muharemović",
                "number": 4,
                "image": "https://images.onefootball.com/players/180/398106.jpg",
                "url": "https://onefootball.com/en/player/tarik-muharemovic-398106"
            },
            {
                "id": 176800,
                "name": "Nikola Katic",
                "number": 18,
                "image": "https://images.onefootball.com/players/180/176800.jpg",
                "url": "https://onefootball.com/en/player/nikola-katic-176800"
            },
            {
                "id": 269041,
                "name": "Amar Dedic",
                "number": 7,
                "image": "https://images.onefootball.com/players/180/269041.jpg",
                "url": "https://onefootball.com/en/player/amar-dedic-269041"
            },
            {
                "id": 49221,
                "name": "Nikola Vasilj",
                "number": 1,
                "image": "https://images.onefootball.com/players/180/49221.jpg",
                "url": "https://onefootball.com/en/player/nikola-vasilj-49221"
            }
        ]
    }
}
Get match lineup — CODE SNIPPETS

curl --location --request GET 'https://zylalabs.com/api/13509/onefootball+api/29917/get+match+lineup?match_id=2650258' --header 'Authorization: Bearer YOUR_API_KEY' 


    
Request
Returns the statistics for a match......
Endpoint ID: 29918
GET https://docs.zylalabs.com/api/13509/onefootball+api/29918/get+match+stats
INPUT PARAMETERS

Get match stats — Endpoint Features

Object Description
match_id Required ID of the match.

Free test requests remaining: 3 of 3.


INPUT PARAMETERS

match_id
API EXAMPLE RESPONSE
JSON
[
    {
        "title": "Possession",
        "home": 48,
        "away": 52,
        "unit": "PERCENT"
    },
    {
        "title": "Total shots",
        "home": 8,
        "away": 10,
        "unit": null
    },
    {
        "title": "Shots on target",
        "home": 2,
        "away": 3,
        "unit": null
    },
    {
        "title": "Duels won",
        "home": 58,
        "away": 43,
        "unit": "PERCENT"
    }
]
Get match stats — CODE SNIPPETS

curl --location --request GET 'https://zylalabs.com/api/13509/onefootball+api/29918/get+match+stats?match_id=2650258' --header 'Authorization: Bearer YOUR_API_KEY' 


    
Request
Returns the fan prediction (votes) for a match.
Endpoint ID: 29919
GET https://docs.zylalabs.com/api/13509/onefootball+api/29919/get+match+prediction
INPUT PARAMETERS

Get match prediction — Endpoint Features

Object Description
match_id Required ID of the match.

Free test requests remaining: 3 of 3.


INPUT PARAMETERS

match_id
API EXAMPLE RESPONSE
JSON
{
    "title": "Who will win?",
    "home": {
        "name": "United States",
        "votes": 36659
    },
    "draw": {
        "name": "Draw",
        "votes": 2453
    },
    "away": {
        "name": "Bosnia & Herzegovina",
        "votes": 13401
    }
}
Get match prediction — CODE SNIPPETS

curl --location --request GET 'https://zylalabs.com/api/13509/onefootball+api/29919/get+match+prediction?match_id=2650258' --header 'Authorization: Bearer YOUR_API_KEY' 


    
Request
Returns the recent form of both teams in a match.
Endpoint ID: 29920
GET https://docs.zylalabs.com/api/13509/onefootball+api/29920/get+match+form+guide
INPUT PARAMETERS

Get match form guide — Endpoint Features

Object Description
match_id Required ID of the match.

Free test requests remaining: 3 of 3.


INPUT PARAMETERS

match_id
API EXAMPLE RESPONSE
JSON
[
    {
        "team": "United States",
        "matches": [
            {
                "id": 2650258,
                "url": "https://onefootball.com/en/match/2650258",
                "datetime": "2026-07-02T00:00:00Z",
                "outcome": "Win",
                "homeTeam": {
                    "id": 81,
                    "name": "United States",
                    "image": "https://images.onefootball.com/icons/teams/164/81.png",
                    "score": "2"
                },
                "awayTeam": {
                    "id": 297,
                    "name": "Bosnia & Herzegovina",
                    "image": "https://images.onefootball.com/icons/teams/164/297.png",
                    "score": "0"
                }
            },
            {
                "id": 2650065,
                "url": "https://onefootball.com/en/match/2650065",
                "datetime": "2026-06-26T02:00:00Z",
                "outcome": "Loss",
                "homeTeam": {
                    "id": 123,
                    "name": "Türkiye",
                    "image": "https://images.onefootball.com/icons/teams/164/123.png",
                    "score": "3"
                },
                "awayTeam": {
                    "id": 81,
                    "name": "United States",
                    "image": "https://images.onefootball.com/icons/teams/164/81.png",
                    "score": "2"
                }
            },
            {
                "id": 2645062,
                "url": "https://onefootball.com/en/match/2645062",
                "datetime": "2026-06-19T19:00:00Z",
                "outcome": "Win",
                "homeTeam": {
                    "id": 81,
                    "name": "United States",
                    "image": "https://images.onefootball.com/icons/teams/164/81.png",
                    "score": "2"
                },
                "awayTeam": {
                    "id": 74,
                    "name": "Australia",
                    "image": "https://images.onefootball.com/icons/teams/164/74.png",
                    "score": "0"
                }
            },
            {
                "id": 2645043,
                "url": "https://onefootball.com/en/match/2645043",
                "datetime": "2026-06-13T01:00:00Z",
                "outcome": "Win",
                "homeTeam": {
                    "id": 81,
                    "name": "United States",
                    "image": "https://images.onefootball.com/icons/teams/164/81.png",
                    "score": "4"
                },
                "awayTeam": {
                    "id": 47,
                    "name": "Paraguay",
                    "image": "https://images.onefootball.com/icons/teams/164/47.png",
                    "score": "1"
                }
            },
            {
                "id": 2657793,
                "url": "https://onefootball.com/en/match/2657793",
                "datetime": "2026-06-06T18:30:00Z",
                "outcome": "Loss",
                "homeTeam": {
                    "id": 81,
                    "name": "United States",
                    "image": "https://images.onefootball.com/icons/teams/164/81.png",
                    "score": "1"
                },
                "awayTeam": {
                    "id": 96,
                    "name": "Germany",
                    "image": "https://images.onefootball.com/icons/teams/164/96.png",
                    "score": "2"
                }
            }
        ]
    },
    {
        "team": "Bosnia & Herzegovina",
        "matches": [
            {
                "id": 2650258,
                "url": "https://onefootball.com/en/match/2650258",
                "datetime": "2026-07-02T00:00:00Z",
                "outcome": "Loss",
                "homeTeam": {
                    "id": 81,
                    "name": "United States",
                    "image": "https://images.onefootball.com/icons/teams/164/81.png",
                    "score": "2"
                },
                "awayTeam": {
                    "id": 297,
                    "name": "Bosnia & Herzegovina",
                    "image": "https://images.onefootball.com/icons/teams/164/297.png",
                    "score": "0"
                }
            },
            {
                "id": 2650060,
                "url": "https://onefootball.com/en/match/2650060",
                "datetime": "2026-06-24T19:00:00Z",
                "outcome": "Win",
                "homeTeam": {
                    "id": 297,
                    "name": "Bosnia & Herzegovina",
                    "image": "https://images.onefootball.com/icons/teams/164/297.png",
                    "score": "3"
                },
                "awayTeam": {
                    "id": 586,
                    "name": "Qatar",
                    "image": "https://images.onefootball.com/icons/teams/164/586.png",
                    "score": "1"
                }
            },
            {
                "id": 2650056,
                "url": "https://onefootball.com/en/match/2650056",
                "datetime": "2026-06-18T19:00:00Z",
                "outcome": "Loss",
                "homeTeam": {
                    "id": 93,
                    "name": "Switzerland",
                    "image": "https://images.onefootball.com/icons/teams/164/93.png",
                    "score": "4"
                },
                "awayTeam": {
                    "id": 297,
                    "name": "Bosnia & Herzegovina",
                    "image": "https://images.onefootball.com/icons/teams/164/297.png",
                    "score": "1"
                }
            },
            {
                "id": 2650050,
                "url": "https://onefootball.com/en/match/2650050",
                "datetime": "2026-06-12T19:00:00Z",
                "outcome": "Draw",
                "homeTeam": {
                    "id": 132,
                    "name": "Canada",
                    "image": "https://images.onefootball.com/icons/teams/164/132.png",
                    "score": "1"
                },
                "awayTeam": {
                    "id": 297,
                    "name": "Bosnia & Herzegovina",
                    "image": "https://images.onefootball.com/icons/teams/164/297.png",
                    "score": "1"
                }
            },
            {
                "id": 2682126,
                "url": "https://onefootball.com/en/match/2682126",
                "datetime": "2026-06-06T19:00:00Z",
                "outcome": "Draw",
                "homeTeam": {
                    "id": 1022,
                    "name": "Panama",
                    "image": "https://images.onefootball.com/icons/teams/164/1022.png",
                    "score": "1"
                },
                "awayTeam": {
                    "id": 297,
                    "name": "Bosnia & Herzegovina",
                    "image": "https://images.onefootball.com/icons/teams/164/297.png",
                    "score": "1"
                }
            }
        ]
    }
]
Get match form guide — CODE SNIPPETS

curl --location --request GET 'https://zylalabs.com/api/13509/onefootball+api/29920/get+match+form+guide?match_id=2650258' --header 'Authorization: Bearer YOUR_API_KEY' 


    
Request
Returns details for a player from OneFootball
Endpoint ID: 29921
GET https://docs.zylalabs.com/api/13509/onefootball+api/29921/get+player+details
INPUT PARAMETERS

Get player details — Endpoint Features

Object Description
player_id Required Player ID.

Free test requests remaining: 3 of 3.


INPUT PARAMETERS

player_id
API EXAMPLE RESPONSE
JSON
{
    "id": 823,
    "name": "Cristiano Ronaldo",
    "image": "https://images.onefootball.com/players/180/823.jpg",
    "club": "Al-Nassr",
    "age": "41",
    "position": "Forward",
    "country": "Portugal",
    "height": "188 cm",
    "weight": "80 kg",
    "number": "7",
    "teams": [
        {
            "id": 43,
            "name": "Portugal",
            "image": "https://images.onefootball.com/icons/teams/164/43.png",
            "url": "https://onefootball.com/en/team/portugal-43"
        },
        {
            "id": 2329,
            "name": "Al-Nassr",
            "image": "https://images.onefootball.com/icons/teams/164/2329.png",
            "url": "https://onefootball.com/en/team/al-nassr-2329"
        }
    ],
    "url": "https://onefootball.com/en/player/cristiano-ronaldo-823"
}
Get player details — CODE SNIPPETS

curl --location --request GET 'https://zylalabs.com/api/13509/onefootball+api/29921/get+player+details?player_id=823' --header 'Authorization: Bearer YOUR_API_KEY' 


    
Request
Returns a player stats for a season, grouped by category.
Endpoint ID: 29922
GET https://docs.zylalabs.com/api/13509/onefootball+api/29922/get+player+stats
INPUT PARAMETERS

Get player stats — Endpoint Features

Object Description
player_id Required Player ID.
season_id Required Season ID.

Free test requests remaining: 3 of 3.


INPUT PARAMETERS

player_id
season_id
API EXAMPLE RESPONSE
JSON
[
    {
        "title": "KEY STATS",
        "stats": [
            {
                "name": "Goals",
                "value": "5"
            },
            {
                "name": "Assists",
                "value": "0"
            },
            {
                "name": "Shot Accuracy",
                "value": "46.15"
            },
            {
                "name": "Pass Accuracy",
                "value": "91.4"
            }
        ]
    },
    {
        "title": "DEFENCE",
        "stats": [
            {
                "name": "Tackles",
                "value": "0"
            },
            {
                "name": "Tackles Won",
                "value": "0.0"
            },
            {
                "name": "Duels",
                "value": "21"
            },
            {
                "name": "Duels won",
                "value": "19.05 %"
            },
            {
                "name": "Aerial duels won",
                "value": "36.36 %"
            },
            {
                "name": "Clearances",
                "value": "0"
            },
            {
                "name": "Blocked shots",
                "value": "0"
            },
            {
                "name": "Interceptions",
                "value": "0"
            }
        ]
    },
    {
        "title": "DISTRIBUTION",
        "stats": [
            {
                "name": "Assists",
                "value": "0"
            },
            {
                "name": "Total passes",
                "value": "93"
            },
            {
                "name": "Pass accuracy",
                "value": "91.4 %"
            },
            {
                "name": "Passes / 90 minutes",
                "value": "22.32"
            },
            {
                "name": "Touches / game",
                "value": "139"
            },
            {
                "name": "Total crosses",
                "value": "1"
            },
            {
                "name": "Cross accuracy",
                "value": "100.00"
            }
        ]
    },
    {
        "title": "OFFENSE",
        "stats": [
            {
                "name": "Goals",
                "value": "5"
            },
            {
                "name": "Minutes / goal",
                "value": "75.0"
            },
            {
                "name": "Shot accuracy",
                "value": "46.15 %"
            },
            {
                "name": "Right foot goals",
                "value": "4"
            },
            {
                "name": "Left foot goals",
                "value": "1"
            },
            {
                "name": "Headed goals",
                "value": "0"
            },
            {
                "name": "Goals - inside the box",
                "value": "4"
            },
            {
                "name": "Goals - outside the box",
                "value": "1"
            },
            {
                "name": "Other goals",
                "value": "0"
            },
            {
                "name": "Successful dribbles",
                "value": "0"
            },
            {
                "name": "Offsides",
                "value": "5"
            }
        ]
    },
    {
        "title": "DISCIPLINE",
        "stats": [
            {
                "name": "Yellow cards",
                "value": "0"
            },
            {
                "name": "Yellow - red cards",
                "value": "0"
            },
            {
                "name": "Red cards",
                "value": "1"
            },
            {
                "name": "Fouls conceded",
                "value": "3"
            },
            {
                "name": "Fouls won",
                "value": "0"
            }
        ]
    }
]
Get player stats — CODE SNIPPETS

curl --location --request GET 'https://zylalabs.com/api/13509/onefootball+api/29922/get+player+stats?player_id=823&season_id=42055' --header 'Authorization: Bearer YOUR_API_KEY' 


    
Request
Returns the seasons/competitions a player has stats for.
Endpoint ID: 29923
GET https://docs.zylalabs.com/api/13509/onefootball+api/29923/get+player+seasons
INPUT PARAMETERS

Get player seasons — Endpoint Features

Object Description
player_id Required Player ID.

Free test requests remaining: 3 of 3.


INPUT PARAMETERS

player_id
API EXAMPLE RESPONSE
JSON
[
    {
        "id": 42055,
        "name": "UEFA World Cup Qualifying"
    },
    {
        "id": 43402,
        "name": "UEFA Nations League"
    },
    {
        "id": 41041,
        "name": "EURO 2024"
    },
    {
        "id": 40183,
        "name": "Euro 2024 Qualifying"
    },
    {
        "id": 43241,
        "name": "World Cup"
    },
    {
        "id": 43342,
        "name": "International Friendlies"
    },
    {
        "id": 43643,
        "name": "Saudi Pro League"
    },
    {
        "id": 43051,
        "name": "Saudi Super Cup"
    },
    {
        "id": 43555,
        "name": "King's Cup"
    },
    {
        "id": 43313,
        "name": "Club Friendly Games"
    },
    {
        "id": 40706,
        "name": "Arab Club Champions Cup"
    }
]
Get player seasons — CODE SNIPPETS

curl --location --request GET 'https://zylalabs.com/api/13509/onefootball+api/29923/get+player+seasons?player_id=823' --header 'Authorization: Bearer YOUR_API_KEY' 


    
Request
Searches teams, competitions, players and news.
Endpoint ID: 29924
GET https://docs.zylalabs.com/api/13509/onefootball+api/29924/search
INPUT PARAMETERS

Search — Endpoint Features

Object Description
q Required Search term.

Free test requests remaining: 3 of 3.


INPUT PARAMETERS

q
API EXAMPLE RESPONSE
JSON
{
    "teams": [
        {
            "id": 26,
            "name": "Real Madrid",
            "country": {
                "name": "Spain",
                "code": "es"
            },
            "image": "https://images.onefootball.com/icons/teams/164/26.png",
            "url": "https://onefootball.com/en/team/real-madrid-26"
        },
        {
            "id": 1142,
            "name": "Real Madrid II",
            "country": {
                "name": "Spain",
                "code": "es"
            },
            "image": "https://images.onefootball.com/icons/teams/164/1142.png",
            "url": "https://onefootball.com/en/team/real-madrid-ii-1142"
        },
        {
            "id": 10668,
            "name": "Real Madrid U19",
            "country": {
                "name": "Spain",
                "code": "es"
            },
            "image": "https://images.onefootball.com/icons/teams/164/10668.png",
            "url": "https://onefootball.com/en/team/real-madrid-u19-10668"
        },
        {
            "id": 60713,
            "name": "Real Madrid U20",
            "country": {
                "name": "Spain",
                "code": "es"
            },
            "image": "https://images.onefootball.com/icons/teams/164/60713.png",
            "url": "https://onefootball.com/en/team/real-madrid-u20-60713"
        },
        {
            "id": 18568,
            "name": "Real Madrid Women",
            "country": {
                "name": "Spain",
                "code": "es"
            },
            "image": "https://images.onefootball.com/icons/teams/164/18568.png",
            "url": "https://onefootball.com/en/team/real-madrid-women-18568"
        }
    ],
    "competitions": [],
    "players": [],
    "news": [
        {
            "id": 43271342,
            "title": "Spanish Super Cup to be played in Istanbul",
            "date": "2026-08-13T14:25:09Z",
            "image": "https://image-service.onefootball.com/crop/face?h=826&image=https%3A%2F%2Fcdn-img.staticzz.com%2Fimg%2Fnoticias%2F538%2FimgS620I1174538T20260813152110.jpg&q=40&w=1240",
            "url": "https://onefootball.com/editorial/43271342?language=en"
        },
        {
            "id": 43271248,
            "title": "Jose Mourinho talks team progression as Real Madrid secure victory in penultimate pre-season friendly",
            "date": "2026-08-13T14:15:14Z",
            "image": "https://image-service.onefootball.com/crop/face?h=4000&image=https%3A%2F%2Ficdn.siempremadrid.com%2Fwp-content%2Fuploads%2F2026%2F08%2Frc-deportivo-a-coruna-v-real-madrid-trofeo-teresa-herrera-1.jpg&q=40&w=5892",
            "url": "https://onefootball.com/editorial/43271248?language=en"
        },
        {
            "id": 43271244,
            "title": "Real Madrid players react to friendly win against Deportivo La Coruna",
            "date": "2026-08-13T14:15:13Z",
            "image": "https://image-service.onefootball.com/crop/face?h=2081&image=https%3A%2F%2Ficdn.siempremadrid.com%2Fwp-content%2Fuploads%2F2026%2F08%2Frc-deportivo-a-coruna-v-real-madrid-trofeo-teresa-herrera-2-1.jpg&q=40&w=3078",
            "url": "https://onefootball.com/editorial/43271244?language=en"
        },
        {
            "id": 43271239,
            "title": "Real Madrid trailing Liverpool in race to sign midfielder",
            "date": "2026-08-13T14:15:12Z",
            "image": "https://image-service.onefootball.com/crop/face?h=2190&image=https%3A%2F%2Ficdn.siempremadrid.com%2Fwp-content%2Fuploads%2F2026%2F08%2Fengland-v-uruguay-international-friendly.jpg&q=40&w=3556",
            "url": "https://onefootball.com/editorial/43271239?language=en"
        },
        {
            "id": 43271109,
            "title": "Atatürk Olympic Stadium to stage 2027 Spanish Super Cup in Istanbul",
            "date": "2026-08-13T13:51:57Z",
            "image": "https://image-service.onefootball.com/crop/face?h=80&image=https%3A%2F%2Fimage-service.onefootball.com%2Fresize%3Ffit%3Dmax%26q%3D40%26w%3D640%26image%3Dhttps%3A%2F%2Ffilebucket.onefootball.com%2F2025%2F12%2F1764849173511-news_update_2.png&q=40&w=1280",
            "url": "https://onefootball.com/editorial/43271109?language=en"
        },
        {
            "id": 43271049,
            "title": "Bellingham delighted by the chance to work with Mourinho at Real Madrid: ‘A dream for me’",
            "date": "2026-08-13T13:40:21Z",
            "image": "https://image-service.onefootball.com/crop/face?h=675&image=https%3A%2F%2Fmadriduniversal.com%2Fwp-content%2Fuploads%2F2026%2F08%2Fimage-20.png&q=40&w=1200",
            "url": "https://onefootball.com/editorial/43271049?language=en"
        },
        {
            "id": 43270809,
            "title": "Real Madrid refuse to force departures as Mourinho’s squad is declared complete",
            "date": "2026-08-13T12:55:16Z",
            "image": "https://image-service.onefootball.com/crop/face?h=1244&image=https%3A%2F%2Fmadriduniversal.com%2Fwp-content%2Fuploads%2F2026%2F08%2Freal-madrid-v-fiorentina-pre-season-friendly-8-scaled.jpg&q=40&w=1920",
            "url": "https://onefootball.com/editorial/43270809?language=en"
        },
        {
            "id": 43270731,
            "title": "José Mourinho lands first trophy of the season with Real Madrid",
            "date": "2026-08-13T12:40:16Z",
            "image": "https://image-service.onefootball.com/crop/face?h=689&image=https%3A%2F%2Fglorioso1904.pt%2Fstorage%2Fmedia-items%2Fimage%2F2026%2F08%2Fjose-mourinho-benfica-real-madrid_20260813013725.webp&q=40&w=1224",
            "url": "https://onefootball.com/editorial/43270731?language=en"
        },
        {
            "id": 43270686,
            "title": "Atlético Madrid Accept €18m Deal as Molina Nears Roma Move",
            "date": "2026-08-13T12:35:09Z",
            "image": "https://image-service.onefootball.com/crop/face?h=675&image=https%3A%2F%2Fwww.football-espana.net%2Fwp-content%2Fuploads%2F2026%2F08%2Fatletico-madrid-accept-18m-deal-molina-roma-move.webp&q=40&w=1200",
            "url": "https://onefootball.com/editorial/43270686?language=en"
        },
        {
            "id": 43270422,
            "title": "Confirmed: Spanish Super Cup 2027 to be held in Istanbul in February",
            "date": "2026-08-13T11:30:23Z",
            "image": "https://image-service.onefootball.com/crop/face?h=1280&image=https%3A%2F%2Fmadriduniversal.com%2Fwp-content%2Fuploads%2F2026%2F08%2Freal-madrid-cf-v-fc-barcelona-super-copa-de-espana-final-scaled.jpg&q=40&w=1920",
            "url": "https://onefootball.com/editorial/43270422?language=en"
        }
    ]
}
Search — CODE SNIPPETS

curl --location --request GET 'https://zylalabs.com/api/13509/onefootball+api/29924/search?q=real madrid' --header 'Authorization: Bearer YOUR_API_KEY' 


    
Request
Returns the alphabetical index of all teams.
Endpoint ID: 29925
GET https://docs.zylalabs.com/api/13509/onefootball+api/29925/get+all+team+letters
INPUT PARAMETERS

Free test requests remaining: 3 of 3.

This endpoint does not require any input parameters.

API EXAMPLE RESPONSE
JSON
[
    {
        "letter": "A",
        "url": "https://onefootball.com/en/all-teams/a"
    },
    {
        "letter": "B",
        "url": "https://onefootball.com/en/all-teams/b"
    },
    {
        "letter": "C",
        "url": "https://onefootball.com/en/all-teams/c"
    },
    {
        "letter": "D",
        "url": "https://onefootball.com/en/all-teams/d"
    },
    {
        "letter": "E",
        "url": "https://onefootball.com/en/all-teams/e"
    },
    {
        "letter": "F",
        "url": "https://onefootball.com/en/all-teams/f"
    },
    {
        "letter": "G",
        "url": "https://onefootball.com/en/all-teams/g"
    },
    {
        "letter": "H",
        "url": "https://onefootball.com/en/all-teams/h"
    },
    {
        "letter": "I",
        "url": "https://onefootball.com/en/all-teams/i"
    },
    {
        "letter": "J",
        "url": "https://onefootball.com/en/all-teams/j"
    },
    {
        "letter": "K",
        "url": "https://onefootball.com/en/all-teams/k"
    },
    {
        "letter": "L",
        "url": "https://onefootball.com/en/all-teams/l"
    },
    {
        "letter": "M",
        "url": "https://onefootball.com/en/all-teams/m"
    },
    {
        "letter": "N",
        "url": "https://onefootball.com/en/all-teams/n"
    },
    {
        "letter": "O",
        "url": "https://onefootball.com/en/all-teams/o"
    },
    {
        "letter": "P",
        "url": "https://onefootball.com/en/all-teams/p"
    },
    {
        "letter": "Q",
        "url": "https://onefootball.com/en/all-teams/q"
    },
    {
        "letter": "R",
        "url": "https://onefootball.com/en/all-teams/r"
    },
    {
        "letter": "S",
        "url": "https://onefootball.com/en/all-teams/s"
    },
    {
        "letter": "T",
        "url": "https://onefootball.com/en/all-teams/t"
    },
    {
        "letter": "U",
        "url": "https://onefootball.com/en/all-teams/u"
    },
    {
        "letter": "V",
        "url": "https://onefootball.com/en/all-teams/v"
    },
    {
        "letter": "W",
        "url": "https://onefootball.com/en/all-teams/w"
    },
    {
        "letter": "X",
        "url": "https://onefootball.com/en/all-teams/x"
    },
    {
        "letter": "Y",
        "url": "https://onefootball.com/en/all-teams/y"
    },
    {
        "letter": "Z",
        "url": "https://onefootball.com/en/all-teams/z"
    }
]
Get all team letters — CODE SNIPPETS

curl --location --request GET 'https://zylalabs.com/api/13509/onefootball+api/29925/get+all+team+letters' --header 'Authorization: Bearer YOUR_API_KEY' 


    
Request
Returns all teams for a letter..........
Endpoint ID: 29926
GET https://docs.zylalabs.com/api/13509/onefootball+api/29926/get+teams+by+letter
INPUT PARAMETERS

Get teams by letter — Endpoint Features

Object Description
letter Required Single letter (a-z) the results are filtered by.

Free test requests remaining: 3 of 3.


INPUT PARAMETERS

letter
API EXAMPLE RESPONSE
JSON
[
    {
        "id": 3944,
        "name": "68 Aksarayspor",
        "url": "https://onefootball.com/en/team/68-aksarayspor-3944"
    },
    {
        "id": 14849,
        "name": "A Quilmes",
        "url": "https://onefootball.com/en/team/a-quilmes-14849"
    },
    {
        "id": 54150,
        "name": "A-Leagues All Stars",
        "url": "https://onefootball.com/en/team/a-leagues-all-stars-54150"
    },
    {
        "id": 50332,
        "name": "A. Melilla",
        "url": "https://onefootball.com/en/team/a-melilla-50332"
    },
    {
        "id": 12501,
        "name": "A.C.S.M.",
        "url": "https://onefootball.com/en/team/acsm-12501"
    },
    {
        "id": 59440,
        "name": "AA Lapalisse Football",
        "url": "https://onefootball.com/en/team/aa-lapalisse-football-59440"
    },
    {
        "id": 5944,
        "name": "AB",
        "url": "https://onefootball.com/en/team/ab-5944"
    },
    {
        "id": 57208,
        "name": "ABB",
        "url": "https://onefootball.com/en/team/abb-57208"
    },
    {
        "id": 2661,
        "name": "ABC",
        "url": "https://onefootball.com/en/team/abc-2661"
    },
    {
        "id": 53033,
        "name": "ABECAT",
        "url": "https://onefootball.com/en/team/abecat-53033"
    },
    {
        "id": 43729,
        "name": "AC Guaratinguetá U20",
        "url": "https://onefootball.com/en/team/ac-guaratingueta-u20-43729"
    },
    {
        "id": 55271,
        "name": "AC Milan U20",
        "url": "https://onefootball.com/en/team/ac-milan-u20-55271"
    },
    {
        "id": 55260,
        "name": "AC Monza U20",
        "url": "https://onefootball.com/en/team/ac-monza-u20-55260"
    },
    {
        "id": 58347,
        "name": "AC Palermo",
        "url": "https://onefootball.com/en/team/ac-palermo-58347"
    },
    {
        "id": 60826,
        "name": "AC Studenterna",
        "url": "https://onefootball.com/en/team/ac-studenterna-60826"
    },
    {
        "id": 58624,
        "name": "ACD Maceratese",
        "url": "https://onefootball.com/en/team/acd-maceratese-58624"
    },
    {
        "id": 29889,
        "name": "ACF Brescia Femminile",
        "url": "https://onefootball.com/en/team/acf-brescia-femminile-29889"
    },
    {
        "id": 23527,
        "name": "ACF Fiorentina U19",
        "url": "https://onefootball.com/en/team/acf-fiorentina-u19-23527"
    },
    {
        "id": 31593,
        "name": "ACF Fiorentina U20",
        "url": "https://onefootball.com/en/team/acf-fiorentina-u20-31593"
    },
    {
        "id": 836,
        "name": "ACR Messina",
        "url": "https://onefootball.com/en/team/acr-messina-836"
    },
    {
        "id": 59938,
        "name": "ACS Academica Balș",
        "url": "https://onefootball.com/en/team/acs-academica-bals-59938"
    },
    {
        "id": 55760,
        "name": "ACS CIL Blaj",
        "url": "https://onefootball.com/en/team/acs-cil-blaj-55760"
    },
    {
        "id": 23578,
        "name": "ACS Kids Tâmpa Braşov",
        "url": "https://onefootball.com/en/team/acs-kids-tampa-brasov-23578"
    },
    {
        "id": 53010,
        "name": "ACS Mediaş",
        "url": "https://onefootball.com/en/team/acs-medias-53010"
    },
    {
        "id": 53083,
        "name": "ACS Progresul Fundulea",
        "url": "https://onefootball.com/en/team/acs-progresul-fundulea-53083"
    },
    {
        "id": 26463,
        "name": "ACS Recolta Gheorghe Doja",
        "url": "https://onefootball.com/en/team/acs-recolta-gheorghe-doja-26463"
    },
    {
        "id": 23580,
        "name": "ACS Unirea Braniştea",
        "url": "https://onefootball.com/en/team/acs-unirea-branistea-23580"
    },
    {
        "id": 56959,
        "name": "ACS Viitorul Arad",
        "url": "https://onefootball.com/en/team/acs-viitorul-arad-56959"
    },
    {
        "id": 5325,
        "name": "ACV",
        "url": "https://onefootball.com/en/team/acv-5325"
    },
    {
        "id": 59471,
        "name": "AD Aracaju",
        "url": "https://onefootball.com/en/team/ad-aracaju-59471"
    },
    {
        "id": 8939,
        "name": "ADESG",
        "url": "https://onefootball.com/en/team/adesg-8939"
    },
    {
        "id": 55788,
        "name": "ADIFFEM",
        "url": "https://onefootball.com/en/team/adiffem-55788"
    },
    {
        "id": 2159,
        "name": "ADO 20",
        "url": "https://onefootball.com/en/team/ado-20-2159"
    },
    {
        "id": 899,
        "name": "ADO Den Haag",
        "url": "https://onefootball.com/en/team/ado-den-haag-899"
    },
    {
        "id": 29724,
        "name": "ADO Den Haag Women",
        "url": "https://onefootball.com/en/team/ado-den-haag-women-29724"
    },
    {
        "id": 20673,
        "name": "ADT",
        "url": "https://onefootball.com/en/team/adt-20673"
    },
    {
        "id": 10986,
        "name": "AEA",
        "url": "https://onefootball.com/en/team/aea-10986"
    },
    {
        "id": 553,
        "name": "AEK Athens",
        "url": "https://onefootball.com/en/team/aek-athens-553"
    },
    {
        "id": 56038,
        "name": "AEK Boco",
        "url": "https://onefootball.com/en/team/aek-boco-56038"
    },
    {
        "id": 900,
        "name": "AEK Larnaca",
        "url": "https://onefootball.com/en/team/aek-larnaca-900"
    },
    {
        "id": 59127,
        "name": "AEK Larnaca U19",
        "url": "https://onefootball.com/en/team/aek-larnaca-u19-59127"
    },
    {
        "id": 1098,
        "name": "AEL Limassol",
        "url": "https://onefootball.com/en/team/ael-limassol-1098"
    },
    {
        "id": 21046,
        "name": "AEM Lleida",
        "url": "https://onefootball.com/en/team/aem-lleida-21046"
    },
    {
        "id": 17556,
        "name": "AERP",
        "url": "https://onefootball.com/en/team/aerp-17556"
    },
    {
        "id": 53024,
        "name": "AF CS Viitorul Curiţa",
        "url": "https://onefootball.com/en/team/af-cs-viitorul-curita-53024"
    },
    {
        "id": 37031,
        "name": "AF Elbasani",
        "url": "https://onefootball.com/en/team/af-elbasani-37031"
    },
    {
        "id": 31285,
        "name": "AFA Olaine",
        "url": "https://onefootball.com/en/team/afa-olaine-31285"
    },
    {
        "id": 27632,
        "name": "AFAD",
        "url": "https://onefootball.com/en/team/afad-27632"
    },
    {
        "id": 2155,
        "name": "AFC",
        "url": "https://onefootball.com/en/team/afc-2155"
    },
    {
        "id": 622,
        "name": "AFC Bournemouth",
        "url": "https://onefootball.com/en/team/afc-bournemouth-622"
    },
    {
        "id": 28660,
        "name": "AFC Bournemouth FC Under 18",
        "url": "https://onefootball.com/en/team/afc-bournemouth-fc-under-18-28660"
    },
    {
        "id": 19335,
        "name": "AFC Bournemouth Women",
        "url": "https://onefootball.com/en/team/afc-bournemouth-women-19335"
    },
    {
        "id": 4790,
        "name": "AFC Eskilstuna",
        "url": "https://onefootball.com/en/team/afc-eskilstuna-4790"
    },
    {
        "id": 1458,
        "name": "AFC Fylde",
        "url": "https://onefootball.com/en/team/afc-fylde-1458"
    },
    {
        "id": 19346,
        "name": "AFC Fylde Women",
        "url": "https://onefootball.com/en/team/afc-fylde-women-19346"
    },
    {
        "id": 57503,
        "name": "AFC Inter Stars 2020 Sibiu",
        "url": "https://onefootball.com/en/team/afc-inter-stars-2020-sibiu-57503"
    },
    {
        "id": 26430,
        "name": "AFC Liverpool",
        "url": "https://onefootball.com/en/team/afc-liverpool-26430"
    },
    {
        "id": 21153,
        "name": "AFC Malmö",
        "url": "https://onefootball.com/en/team/afc-malmoe-21153"
    },
    {
        "id": 7441,
        "name": "AFC Mansfield",
        "url": "https://onefootball.com/en/team/afc-mansfield-7441"
    },
    {
        "id": 30263,
        "name": "AFC Portchester",
        "url": "https://onefootball.com/en/team/afc-portchester-30263"
    },
    {
        "id": 51956,
        "name": "AFC Portchester Ladies",
        "url": "https://onefootball.com/en/team/afc-portchester-ladies-51956"
    },
    {
        "id": 7037,
        "name": "AFC Rushden & Diamonds",
        "url": "https://onefootball.com/en/team/afc-rushden-diamonds-7037"
    },
    {
        "id": 8290,
        "name": "AFC Stoneham",
        "url": "https://onefootball.com/en/team/afc-stoneham-8290"
    },
    {
        "id": 20449,
        "name": "AFC Stoneham Ladies",
        "url": "https://onefootball.com/en/team/afc-stoneham-ladies-20449"
    },
    {
        "id": 54897,
        "name": "AFC Sudbury",
        "url": "https://onefootball.com/en/team/afc-sudbury-54897"
    },
    {
        "id": 20347,
        "name": "AFC Sudbury",
        "url": "https://onefootball.com/en/team/afc-sudbury-20347"
    },
    {
        "id": 56859,
        "name": "AFC Toronto",
        "url": "https://onefootball.com/en/team/afc-toronto-56859"
    },
    {
        "id": 1460,
        "name": "AFC Totton"
    },
    {
        "_note": "Response truncated for documentation purposes"
    }
]
Get teams by letter — CODE SNIPPETS

curl --location --request GET 'https://zylalabs.com/api/13509/onefootball+api/29926/get+teams+by+letter?letter=a' --header 'Authorization: Bearer YOUR_API_KEY' 


    
Request
Returns details for a team..............
Endpoint ID: 29927
GET https://docs.zylalabs.com/api/13509/onefootball+api/29927/get+team+details
INPUT PARAMETERS

Get team details — Endpoint Features

Object Description
team_id Required ID of the team.

Free test requests remaining: 3 of 3.


INPUT PARAMETERS

team_id
API EXAMPLE RESPONSE
JSON
{
    "id": 26,
    "name": "Real Madrid",
    "image": "https://images.onefootball.com/icons/teams/164/26.png",
    "url": "https://onefootball.com/en/team/real-madrid-26"
}
Get team details — CODE SNIPPETS

curl --location --request GET 'https://zylalabs.com/api/13509/onefootball+api/29927/get+team+details?team_id=26' --header 'Authorization: Bearer YOUR_API_KEY' 


    
Request
Returns the upcoming fixtures for a team, grouped by month.
Endpoint ID: 29928
GET https://docs.zylalabs.com/api/13509/onefootball+api/29928/get+team+fixtures
INPUT PARAMETERS

Get team fixtures — Endpoint Features

Object Description
team_id Required ID of the team.

Free test requests remaining: 3 of 3.


INPUT PARAMETERS

team_id
API EXAMPLE RESPONSE
JSON
[
    {
        "name": "August 2026",
        "matches": [
            {
                "id": 2720425,
                "url": "https://onefootball.com/en/match/2720425",
                "datetime": "2026-08-16T15:00:00Z",
                "timePeriod": null,
                "period": "PRE_MATCH",
                "status": {
                    "isCancelled": false,
                    "isPostponed": false,
                    "isStarted": false,
                    "isInProgress": false,
                    "isFinished": false,
                    "isFinishedAfterPenalties": false
                },
                "homeTeam": {
                    "id": 144,
                    "name": "Schalke 04",
                    "image": "https://images.onefootball.com/icons/teams/164/144.png"
                },
                "awayTeam": {
                    "id": 26,
                    "name": "Real Madrid",
                    "image": "https://images.onefootball.com/icons/teams/164/26.png"
                }
            },
            {
                "id": 2700199,
                "url": "https://onefootball.com/en/match/2700199",
                "datetime": "2026-08-22T19:30:00Z",
                "timePeriod": null,
                "period": "PRE_MATCH",
                "status": {
                    "isCancelled": false,
                    "isPostponed": false,
                    "isStarted": false,
                    "isInProgress": false,
                    "isFinished": false,
                    "isFinishedAfterPenalties": false
                },
                "homeTeam": {
                    "id": 215,
                    "name": "Espanyol",
                    "image": "https://images.onefootball.com/icons/teams/164/215.png"
                },
                "awayTeam": {
                    "id": 26,
                    "name": "Real Madrid",
                    "image": "https://images.onefootball.com/icons/teams/164/26.png"
                }
            },
            {
                "id": 2700192,
                "url": "https://onefootball.com/en/match/2700192",
                "datetime": "2026-08-26T19:00:00Z",
                "timePeriod": null,
                "period": "PRE_MATCH",
                "status": {
                    "isCancelled": false,
                    "isPostponed": false,
                    "isStarted": false,
                    "isInProgress": false,
                    "isFinished": false,
                    "isFinishedAfterPenalties": false
                },
                "homeTeam": {
                    "id": 26,
                    "name": "Real Madrid",
                    "image": "https://images.onefootball.com/icons/teams/164/26.png"
                },
                "awayTeam": {
                    "id": 223,
                    "name": "Real Sociedad",
                    "image": "https://images.onefootball.com/icons/teams/164/223.png"
                }
            },
            {
                "id": 2700212,
                "url": "https://onefootball.com/en/match/2700212",
                "datetime": "2026-08-30T15:00:00Z",
                "timePeriod": null,
                "period": "PRE_MATCH",
                "status": {
                    "isCancelled": false,
                    "isPostponed": false,
                    "isStarted": false,
                    "isInProgress": false,
                    "isFinished": false,
                    "isFinishedAfterPenalties": false
                },
                "homeTeam": {
                    "id": 26,
                    "name": "Real Madrid",
                    "image": "https://images.onefootball.com/icons/teams/164/26.png"
                },
                "awayTeam": {
                    "id": 219,
                    "name": "Málaga",
                    "image": "https://images.onefootball.com/icons/teams/164/219.png"
                }
            }
        ]
    },
    {
        "name": "September 2026",
        "matches": [
            {
                "id": 2700217,
                "url": "https://onefootball.com/en/match/2700217",
                "datetime": "2026-09-04T19:00:00Z",
                "timePeriod": null,
                "period": "PRE_MATCH",
                "status": {
                    "isCancelled": false,
                    "isPostponed": false,
                    "isStarted": false,
                    "isInProgress": false,
                    "isFinished": false,
                    "isFinishedAfterPenalties": false
                },
                "homeTeam": {
                    "id": 691,
                    "name": "Real Betis",
                    "image": "https://images.onefootball.com/icons/teams/164/691.png"
                },
                "awayTeam": {
                    "id": 26,
                    "name": "Real Madrid",
                    "image": "https://images.onefootball.com/icons/teams/164/26.png"
                }
            },
            {
                "id": 2700231,
                "url": "https://onefootball.com/en/match/2700231",
                "datetime": "2026-09-13T12:00:00Z",
                "timePeriod": null,
                "period": "PRE_MATCH",
                "status": {
                    "isCancelled": false,
                    "isPostponed": false,
                    "isStarted": false,
                    "isInProgress": false,
                    "isFinished": false,
                    "isFinishedAfterPenalties": false
                },
                "homeTeam": {
                    "id": 26,
                    "name": "Real Madrid",
                    "image": "https://images.onefootball.com/icons/teams/164/26.png"
                },
                "awayTeam": {
                    "id": 690,
                    "name": "Rayo Vallecano",
                    "image": "https://images.onefootball.com/icons/teams/164/690.png"
                }
            },
            {
                "id": 2700239,
                "url": "https://onefootball.com/en/match/2700239",
                "datetime": "2026-09-16T12:00:00Z",
                "timePeriod": null,
                "period": "PRE_MATCH",
                "status": {
                    "isCancelled": false,
                    "isPostponed": false,
                    "isStarted": false,
                    "isInProgress": false,
                    "isFinished": false,
                    "isFinishedAfterPenalties": false
                },
                "homeTeam": {
                    "id": 682,
                    "name": "Elche",
                    "image": "https://images.onefootball.com/icons/teams/164/682.png"
                },
                "awayTeam": {
                    "id": 26,
                    "name": "Real Madrid",
                    "image": "https://images.onefootball.com/icons/teams/164/26.png"
                }
            },
            {
                "id": 2700246,
                "url": "https://onefootball.com/en/match/2700246",
                "datetime": "2026-09-20T12:00:00Z",
                "timePeriod": null,
                "period": "PRE_MATCH",
                "status": {
                    "isCancelled": false,
                    "isPostponed": false,
                    "isStarted": false,
                    "isInProgress": false,
                    "isFinished": false,
                    "isFinishedAfterPenalties": false
                },
                "homeTeam": {
                    "id": 3,
                    "name": "Atlético de Madrid",
                    "image": "https://images.onefootball.com/icons/teams/164/3.png"
                },
                "awayTeam": {
                    "id": 26,
                    "name": "Real Madrid",
                    "image": "https://images.onefootball.com/icons/teams/164/26.png"
                }
            }
        ]
    },
    {
        "name": "October 2026",
        "matches": [
            {
                "id": 2700263,
                "url": "https://onefootball.com/en/match/2700263",
                "datetime": "2026-10-11T12:00:00Z",
                "timePeriod": null,
                "period": "PRE_MATCH",
                "status": {
                    "isCancelled": false,
                    "isPostponed": false,
                    "isStarted": false,
                    "isInProgress": false,
                    "isFinished": false,
                    "isFinishedAfterPenalties": false
                },
                "homeTeam": {
                    "id": 26,
                    "name": "Real Madrid",
                    "image": "https://images.onefootball.com/icons/teams/164/26.png"
                },
                "awayTeam": {
                    "id": 226,
                    "name": "Villarreal",
                    "image": "https://images.onefootball.com/icons/teams/164/226.png"
                }
            }
        ]
    },
    {
        "name": "October 2026",
        "matches": [
            {
                "id": 2700272,
                "url": "https://onefootball.com/en/match/2700272",
                "datetime": "2026-10-18T12:00:00Z"
            }
        ]
    },
    {
        "_note": "Response truncated for documentation purposes"
    }
]
Get team fixtures — CODE SNIPPETS

curl --location --request GET 'https://zylalabs.com/api/13509/onefootball+api/29928/get+team+fixtures?team_id=26' --header 'Authorization: Bearer YOUR_API_KEY' 


    
Request
Returns the past results for a team, grouped by month.
Endpoint ID: 29929
GET https://docs.zylalabs.com/api/13509/onefootball+api/29929/get+team+results
INPUT PARAMETERS

Get team results — Endpoint Features

Object Description
team_id Required ID of the team.

Free test requests remaining: 3 of 3.


INPUT PARAMETERS

team_id
API EXAMPLE RESPONSE
JSON
[{"name":"August 2026","matches":[{"id":2707086,"url":"https:\/\/onefootball.com\/en\/match\/2707086","datetime":"2026-08-12T19:00:00Z","timePeriod":"Full time","period":"FULL_TIME","status":{"isCancelled":false,"isPostponed":false,"isStarted":true,"isInProgress":false,"isFinished":true,"isFinishedAfterPenalties":false},"homeTeam":{"id":214,"name":"Deportivo A Coru\u00f1a","image":"https:\/\/images.onefootball.com\/icons\/teams\/164\/214.png","score":"0"},"awayTeam":{"id":26,"name":"Real Madrid","image":"https:\/\/images.onefootball.com\/icons\/teams\/164\/26.png","score":"1"}},{"id":2716753,"url":"https:\/\/onefootball.com\/en\/match\/2716753","datetime":"2026-08-08T17:00:00Z","timePeriod":"Full time","period":"FULL_TIME","status":{"isCancelled":false,"isPostponed":false,"isStarted":true,"isInProgress":false,"isFinished":true,"isFinishedAfterPenalties":false},"homeTeam":{"id":932,"name":"Ferencv\u00e1ros","image":"https:\/\/images.onefootball.com\/icons\/teams\/164\/932.png","score":"1"},"awayTeam":{"id":26,"name":"Real Madrid","image":"https:\/\/images.onefootball.com\/icons\/teams\/164\/26.png","score":"2"}},{"id":2709950,"url":"https:\/\/onefootball.com\/en\/match\/2709950","datetime":"2026-08-01T16:00:00Z","timePeriod":"Full time","period":"FULL_TIME","status":{"isCancelled":false,"isPostponed":false,"isStarted":true,"isInProgress":false,"isFinished":true,"isFinishedAfterPenalties":false},"homeTeam":{"id":26,"name":"Real Madrid","image":"https:\/\/images.onefootball.com\/icons\/teams\/164\/26.png","score":"2"},"awayTeam":{"id":15,"name":"Fiorentina","image":"https:\/\/images.onefootball.com\/icons\/teams\/164\/15.png","score":"2"}}]},{"name":"January 2026","matches":[{"id":2659806,"url":"https:\/\/onefootball.com\/en\/match\/2659806","datetime":"2026-01-14T20:00:00Z","timePeriod":"Full time","period":"FULL_TIME","status":{"isCancelled":false,"isPostponed":false,"isStarted":true,"isInProgress":false,"isFinished":true,"isFinishedAfterPenalties":false},"homeTeam":{"id":678,"name":"Albacete","image":"https:\/\/images.onefootball.com\/icons\/teams\/164\/678.png","score":"3"},"awayTeam":{"id":26,"name":"Real Madrid","image":"https:\/\/images.onefootball.com\/icons\/teams\/164\/26.png","score":"2"}}]},{"name":"December 2025","matches":[{"id":2650070,"url":"https:\/\/onefootball.com\/en\/match\/2650070","datetime":"2025-12-17T20:00:00Z","timePeriod":"Full time","period":"FULL_TIME","status":{"isCancelled":false,"isPostponed":false,"isStarted":true,"isInProgress":false,"isFinished":true,"isFinishedAfterPenalties":false},"homeTeam":{"id":5740,"name":"Talavera","image":"https:\/\/images.onefootball.com\/icons\/teams\/164\/5740.png","score":"2"},"awayTeam":{"id":26,"name":"Real Madrid","image":"https:\/\/images.onefootball.com\/icons\/teams\/164\/26.png","score":"3"}}]},{"name":"July 2025","matches":[{"id":2593163,"url":"https:\/\/onefootball.com\/en\/match\/2593163","datetime":"2025-07-09T19:10:00Z","timePeriod":"Full time","period":"FULL_TIME","status":{"isCancelled":false,"isPostponed":false,"isStarted":true,"isInProgress":false,"isFinished":true,"isFinishedAfterPenalties":false},"homeTeam":{"id":263,"name":"PSG","image":"https:\/\/images.onefootball.com\/icons\/teams\/164\/263.png","score":"4"},"awayTeam":{"id":26,"name":"Real Madrid","image":"https:\/\/images.onefootball.com\/icons\/teams\/164\/26.png","score":"0"}},{"id":2593161,"url":"https:\/\/onefootball.com\/en\/match\/2593161","datetime":"2025-07-05T20:00:00Z","timePeriod":"Full time","period":"FULL_TIME","status":{"isCancelled":false,"isPostponed":false,"isStarted":true,"isInProgress":false,"isFinished":true,"isFinishedAfterPenalties":false},"homeTeam":{"id":26,"name":"Real Madrid","image":"https:\/\/images.onefootball.com\/icons\/teams\/164\/26.png","score":"3"},"awayTeam":{"id":155,"name":"Borussia Dortmund","image":"https:\/\/images.onefootball.com\/icons\/teams\/164\/155.png","score":"2"}},{"id":2593156,"url":"https:\/\/onefootball.com\/en\/match\/2593156","datetime":"2025-07-01T19:00:00Z","timePeriod":"Full time","period":"FULL_TIME","status":{"isCancelled":false,"isPostponed":false,"isStarted":true,"isInProgress":false,"isFinished":true,"isFinishedAfterPenalties":false},"homeTeam":{"id":26,"name":"Real Madrid","image":"https:\/\/images.onefootball.com\/icons\/teams\/164\/26.png","score":"1"},"awayTeam":{"id":17,"name":"Juventus","image":"https:\/\/images.onefootball.com\/icons\/teams\/164\/17.png","score":"0"}}]},{"name":"June 2025","matches":[{"id":2558752,"url":"https:\/\/onefootball.com\/en\/match\/2558752","datetime":"2025-06-27T01:00:00Z","timePeriod":"Full time","period":"FULL_TIME","status":{"isCancelled":false,"isPostponed":false,"isStarted":true,"isInProgress":false,"isFinished":true,"isFinishedAfterPenalties":false},"homeTeam":{"id":379,"name":"RB Salzburg","image":"https:\/\/images.onefootball.com\/icons\/teams\/164\/379.png","score":"0"},"awayTeam":{"id":26,"name":"Real Madrid","image":"https:\/\/images.onefootball.com\/icons\/teams\/164\/26.png","score":"3"}},{"id":2558735,"url":"https:\/\/onefootball.com\/en\/match\/2558735","datetime":"2025-06-22T19:00:00Z","timePeriod":"Full time","period":"FULL_TIME","status":{"isCancelled":false,"isPostponed":false,"isStarted":true,"isInProgress":false,"isFinished":true,"isFinishedAfterPenalties":false},"homeTeam":{"id":26,"name":"Real Madrid","image":"https:\/\/images.onefootball.com\/icons\/teams\/164\/26.png","score":"3"},"awayTeam":{"id":1838,"name":"Pachuca","image":"https:\/\/images.onefootball.com\/icons\/teams\/164\/1838.png","score":"1"}}]},{"name":"June 2025","matches":[{"id":2558716,"url":"https:\/\/onefootball.com\/en\/match\/2558716","datetime":"2025-06-18T19:00:00Z","timePeriod":"Full time","period":"FULL_TIME","status":{"isCancelled":false,"isPostponed":false,"isStarted":true,"isInProgress":false,"isFinished":true,"isFinishedAfterPenalties":false},"homeTeam":{"id":26,"name":"Real Madrid","image":"https:\/\/images.onefootball.com\/icons\/teams\/164\/26.png","score":"1"},"awayTeam":{"id":2328,"name":"Al-Hilal","image":"https:\/\/images.onefootball.com\/icons\/teams\/164\/2328.png","score":"1"}}]}]
Get team results — CODE SNIPPETS

curl --location --request GET 'https://zylalabs.com/api/13509/onefootball+api/29929/get+team+results?team_id=26' --header 'Authorization: Bearer YOUR_API_KEY' 


    
Request
Returns the squad of a team, grouped by position.
Endpoint ID: 29930
GET https://docs.zylalabs.com/api/13509/onefootball+api/29930/get+team+squad
INPUT PARAMETERS

Get team squad — Endpoint Features

Object Description
team_id Required ID of the team.

Free test requests remaining: 3 of 3.


INPUT PARAMETERS

team_id
API EXAMPLE RESPONSE
JSON
[
    {
        "position": "Goalkeeper",
        "players": [
            {
                "id": 48058,
                "name": "Andriy Lunin",
                "number": 13,
                "position": "Goalkeeper",
                "image": "https://images.onefootball.com/players/180/48058.jpg",
                "url": "https://onefootball.com/en/player/andriy-lunin-48058"
            },
            {
                "id": 615454,
                "name": "Javi Navarro",
                "number": 29,
                "position": "Goalkeeper",
                "image": "https://images.onefootball.com/players/180/615454.jpg",
                "url": "https://onefootball.com/en/player/javi-navarro-615454"
            },
            {
                "id": 514089,
                "name": "Sergio Mestre",
                "number": 43,
                "position": "Goalkeeper",
                "image": "https://images.onefootball.com/players/180/514089.jpg",
                "url": "https://onefootball.com/en/player/sergio-mestre-514089"
            },
            {
                "id": 9719,
                "name": "Thibaut Courtois",
                "number": 1,
                "position": "Goalkeeper",
                "image": "https://images.onefootball.com/players/180/9719.jpg",
                "url": "https://onefootball.com/en/player/thibaut-courtois-9719"
            }
        ]
    },
    {
        "position": "DEFENCE",
        "players": [
            {
                "id": 611415,
                "name": "Aimar García",
                "number": null,
                "position": "Defender",
                "image": "https://images.onefootball.com/players/180/611415.jpg",
                "url": "https://onefootball.com/en/player/aimar-garcia-611415"
            },
            {
                "id": 20953,
                "name": "Antonio Rüdiger",
                "number": 22,
                "position": "Defender",
                "image": "https://images.onefootball.com/players/180/20953.jpg",
                "url": "https://onefootball.com/en/player/antonio-ruediger-20953"
            },
            {
                "id": 463335,
                "name": "Dean Huijsen",
                "number": 4,
                "position": "Defender",
                "image": "https://images.onefootball.com/players/180/463335.jpg",
                "url": "https://onefootball.com/en/player/dean-huijsen-463335"
            },
            {
                "id": 96338,
                "name": "Denzel Dumfries",
                "number": 24,
                "position": "Defender",
                "image": "https://images.onefootball.com/players/180/96338.jpg",
                "url": "https://onefootball.com/en/player/denzel-dumfries-96338"
            },
            {
                "id": 120836,
                "name": "Ferland Mendy",
                "number": 23,
                "position": "Defender",
                "image": "https://images.onefootball.com/players/180/120836.jpg",
                "url": "https://onefootball.com/en/player/ferland-mendy-120836"
            },
            {
                "id": 200826,
                "name": "Ibrahima Konaté",
                "number": 16,
                "position": "Defender",
                "image": "https://images.onefootball.com/players/180/200826.jpg",
                "url": "https://onefootball.com/en/player/ibrahima-konate-200826"
            },
            {
                "id": 553436,
                "name": "Jesús Fortea",
                "number": 32,
                "position": "Defender",
                "image": "https://images.onefootball.com/players/180/553436.jpg",
                "url": "https://onefootball.com/en/player/jesus-fortea-553436"
            },
            {
                "id": 555725,
                "name": "Joan Martínez",
                "number": 36,
                "position": "Defender",
                "image": "https://images.onefootball.com/players/180/555725.jpg",
                "url": "https://onefootball.com/en/player/joan-martinez-555725"
            },
            {
                "id": 609541,
                "name": "Lamini Fati",
                "number": 48,
                "position": "Defender",
                "image": "https://images.onefootball.com/players/180/609541.jpg",
                "url": "https://onefootball.com/en/player/lamini-fati-609541"
            },
            {
                "id": 188965,
                "name": "Marc Cucurella",
                "number": 17,
                "position": "Defender",
                "image": "https://images.onefootball.com/players/180/188965.jpg",
                "url": "https://onefootball.com/en/player/marc-cucurella-188965"
            },
            {
                "id": 602174,
                "name": "Mario Rivas",
                "number": 49,
                "position": "Defender",
                "image": "https://images.onefootball.com/players/180/602174.jpg",
                "url": "https://onefootball.com/en/player/mario-rivas-602174"
            },
            {
                "id": 454811,
                "name": "Raúl Asencio",
                "number": 2,
                "position": "Defender",
                "image": "https://images.onefootball.com/players/180/454811.jpg",
                "url": "https://onefootball.com/en/player/raul-asencio-454811"
            },
            {
                "id": 187991,
                "name": "Trent Alexander-Arnold",
                "number": 12,
                "position": "Defender",
                "image": "https://images.onefootball.com/players/180/187991.jpg",
                "url": "https://onefootball.com/en/player/trent-alexander-arnold-187991"
            },
            {
                "id": 416495,
                "name": "Álvaro Carreras",
                "number": 18,
                "position": "Defender",
                "image": "https://images.onefootball.com/players/180/416495.jpg",
                "url": "https://onefootball.com/en/player/alvaro-carreras-416495"
            },
            {
                "id": 168738,
                "name": "Éder Militão",
                "number": 3,
                "position": "Defender",
                "image": "https://images.onefootball.com/players/180/168738.jpg",
                "url": "https://onefootball.com/en/player/eder-militao-168738"
            }
        ]
    },
    {
        "position": "Midfielder",
        "players": [
            {
                "id": 416314,
                "name": "Arda Güler",
                "number": 15,
                "position": "Midfielder",
                "image": "https://images.onefootball.com/players/180/416314.jpg",
                "url": "https://onefootball.com/en/player/arda-gueler-416314"
            },
            {
                "id": 195848,
                "name": "Aurélien Tchouaméni",
                "number": 14,
                "position": "Midfielder",
                "image": "https://images.onefootball.com/players/180/195848.jpg",
                "url": "https://onefootball.com/en/player/aurelien-tchouameni-195848"
            },
            {
                "id": 63999,
                "name": "Bernardo Silva",
                "number": 20,
                "position": "Midfielder",
                "image": "https://images.onefootball.com/players/180/63999.jpg",
                "url": "https://onefootball.com/en/player/bernardo-silva-63999"
            },
            {
                "id": 193595,
                "name": "Brahim Diaz",
                "number": 21,
                "position": "Midfielder",
                "image": "https://images.onefootball.com/players/180/193595.jpg",
                "url": "https://onefootball.com/en/player/brahim-diaz-193595"
            },
            {
                "id": 562931,
                "name": "Cestero",
                "number": 28,
                "position": "Midfielder",
                "image": "https://images.onefootball.com/players/180/562931.jpg",
                "url": "https://onefootball.com/en/player/cestero-562931"
            },
            {
                "id": 631181,
                "name": "Diego Lacosta",
                "number": null,
                "position": "Midfielder",
                "image": "https://images.onefootball.com/players/180/631181.jpg",
                "url": "https://onefootball.com/en/player/diego-lacosta-631181"
            },
            {
                "id": 271651,
                "name": "Eduardo Camavinga",
                "number": 6,
                "position": "Midfielder",
                "image": "https://images.onefootball.com/players/180/271651.jpg",
                "url": "https://onefootball.com/en/player/eduardo-camavinga-271651"
            },
            {
                "id": 176958,
                "name": "Federico Valverde",
                "number": 8,
                "position": "Midfielder",
                "image": "https://images.onefootball.com/players/180/176958.jpg",
                "url": "https://onefootball.com/en/player/federico-valverde-176958"
            },
            {
                "id": 343087,
                "name": "Jude Bellingham",
                "number": 5,
                "position": "Midfielder",
                "image": "https://images.onefootball.com/players/180/343087.jpg"
            }
        ]
    },
    {
        "_note": "Response truncated for documentation purposes"
    }
]
Get team squad — CODE SNIPPETS

curl --location --request GET 'https://zylalabs.com/api/13509/onefootball+api/29930/get+team+squad?team_id=26' --header 'Authorization: Bearer YOUR_API_KEY' 


    
Request
Returns the transfers for a team..........
Endpoint ID: 29931
GET https://docs.zylalabs.com/api/13509/onefootball+api/29931/get+team+transfers
INPUT PARAMETERS

Get team transfers — Endpoint Features

Object Description
team_id Required ID of the team.

Free test requests remaining: 3 of 3.


INPUT PARAMETERS

team_id
API EXAMPLE RESPONSE
JSON
[
    {
        "id": "43239805",
        "status": "CONTRACT RENEWAL",
        "url": "https://onefootball.com/en/transfers/43239805",
        "player": {
            "id": 201900,
            "name": "Vinícius Júnior",
            "position": "Forward",
            "image": "https://images.onefootball.com/players/180/201900.jpg"
        },
        "transferDatetime": "2026-08-06T18:42:57Z",
        "price": "RENEWAL",
        "teamOld": {
            "name": "Real Madrid"
        },
        "teamNew": {
            "id": 26,
            "name": "Real Madrid",
            "image": "https://images.onefootball.com/icons/teams/164/26.png"
        }
    },
    {
        "id": "43225468",
        "status": "DONE DEAL",
        "url": "https://onefootball.com/en/transfers/43225468",
        "player": {
            "id": 454785,
            "name": "Gonzalo García",
            "position": "Forward",
            "image": "https://images.onefootball.com/players/180/454785.jpg"
        },
        "transferDatetime": "2026-08-03T20:12:48Z",
        "price": "€40,000,000.00",
        "teamOld": {
            "name": "Real Madrid"
        },
        "teamNew": {
            "id": 211,
            "name": "Fulham",
            "image": "https://images.onefootball.com/icons/teams/164/211.png"
        }
    },
    {
        "id": "43222178",
        "status": "DONE DEAL",
        "url": "https://onefootball.com/en/transfers/43222178",
        "player": {
            "id": 513926,
            "name": "Fran González",
            "position": "Goalkeeper",
            "image": "https://images.onefootball.com/players/180/513926.jpg"
        },
        "transferDatetime": "2026-08-03T06:00:48Z",
        "price": null,
        "teamOld": {
            "name": "Real Madrid"
        },
        "teamNew": {
            "id": 28,
            "name": "Sevilla",
            "image": "https://images.onefootball.com/icons/teams/164/28.png"
        }
    },
    {
        "id": "43114720",
        "status": "DONE DEAL",
        "url": "https://onefootball.com/en/transfers/43114720",
        "player": {
            "id": 279639,
            "name": "Fran García",
            "position": "Defender",
            "image": "https://images.onefootball.com/players/180/279639.jpg"
        },
        "transferDatetime": "2026-07-08T19:42:35Z",
        "price": "€4,000,000.00",
        "teamOld": {
            "name": "Real Madrid"
        },
        "teamNew": {
            "id": 691,
            "name": "Real Betis",
            "image": "https://images.onefootball.com/icons/teams/164/691.png"
        }
    },
    {
        "id": "43099140",
        "status": "DONE DEAL",
        "url": "https://onefootball.com/en/transfers/43099140",
        "player": {
            "id": 96338,
            "name": "Denzel Dumfries",
            "position": "Defender",
            "image": "https://images.onefootball.com/players/180/96338.jpg"
        },
        "transferDatetime": "2026-07-05T10:18:35Z",
        "price": null,
        "teamOld": {
            "name": "Inter"
        },
        "teamNew": {
            "id": 26,
            "name": "Real Madrid",
            "image": "https://images.onefootball.com/icons/teams/164/26.png"
        }
    },
    {
        "id": "43025049",
        "status": "DONE DEAL",
        "url": "https://onefootball.com/en/transfers/43025049",
        "player": {
            "id": 200826,
            "name": "Ibrahima Konaté",
            "position": "Defender",
            "image": "https://images.onefootball.com/players/180/200826.jpg"
        },
        "transferDatetime": "2026-06-18T09:12:13Z",
        "price": "FREE",
        "teamOld": {
            "name": "Liverpool FC"
        },
        "teamNew": {
            "id": 26,
            "name": "Real Madrid",
            "image": "https://images.onefootball.com/icons/teams/164/26.png"
        }
    },
    {
        "id": "43020199",
        "status": "DONE DEAL",
        "url": "https://onefootball.com/en/transfers/43020199",
        "player": {
            "id": 63999,
            "name": "Bernardo Silva",
            "position": "Midfielder",
            "image": "https://images.onefootball.com/players/180/63999.jpg"
        },
        "transferDatetime": "2026-06-17T09:12:13Z",
        "price": "FREE",
        "teamOld": {
            "name": "Manchester City"
        },
        "teamNew": {
            "id": 26,
            "name": "Real Madrid",
            "image": "https://images.onefootball.com/icons/teams/164/26.png"
        }
    },
    {
        "id": "43020182",
        "status": "DONE DEAL",
        "url": "https://onefootball.com/en/transfers/43020182",
        "player": {
            "id": 63999,
            "name": "Bernardo Silva",
            "position": "Midfielder",
            "image": "https://images.onefootball.com/players/180/63999.jpg"
        },
        "transferDatetime": "2026-06-17T09:09:14Z",
        "price": "FREE",
        "teamOld": {
            "name": "Manchester City"
        },
        "teamNew": {
            "id": 26,
            "name": "Real Madrid",
            "image": "https://images.onefootball.com/icons/teams/164/26.png"
        }
    },
    {
        "id": "43015401",
        "status": "CONTRACT RENEWAL",
        "url": "https://onefootball.com/en/transfers/43015401",
        "player": {
            "id": 20953,
            "name": "Antonio Rüdiger",
            "position": "Defender",
            "image": "https://images.onefootball.com/players/180/20953.jpg"
        },
        "transferDatetime": "2026-06-16T09:15:13Z",
        "price": "RENEWAL",
        "teamOld": {
            "name": "Real Madrid"
        },
        "teamNew": {
            "id": 26,
            "name": "Real Madrid",
            "image": "https://images.onefootball.com/icons/teams/164/26.png"
        }
    },
    {
        "id": "43010877",
        "status": "DONE DEAL",
        "url": "https://onefootball.com/en/transfers/43010877",
        "player": {
            "id": 188965,
            "name": "Marc Cucurella",
            "position": "Defender",
            "image": "https://images.onefootball.com/players/180/188965.jpg"
        },
        "transferDatetime": "2026-06-15T09:24:13Z",
        "price": "€55,000,000.00",
        "teamOld": {
            "name": "Chelsea"
        },
        "teamNew": {
            "id": 26,
            "name": "Real Madrid",
            "image": "https://images.onefootball.com/icons/teams/164/26.png"
        }
    },
    {
        "id": "43008441",
        "status": "DONE DEAL",
        "url": "https://onefootball.com/en/transfers/43008441",
        "player": {
            "id": 188965,
            "name": "Marc Cucurella",
            "position": "Defender",
            "image": "https://images.onefootball.com/players/180/188965.jpg"
        },
        "transferDatetime": "2026-06-14T16:45:14Z",
        "price": "€55,000,000.00",
        "teamOld": {
            "name": "Chelsea"
        },
        "teamNew": {
            "id": 26,
            "name": "Real Madrid",
            "image": "https://images.onefootball.com/icons/teams/164/26.png"
        }
    },
    {
        "id": "42933803",
        "status": "DONE DEAL",
        "url": "https://onefootball.com/en/transfers/42933803",
        "player": {
            "id": 461111,
            "name": "Mario Martín",
            "position": "Midfielder",
            "image": "https://images.onefootball.com/players/180/461111.jpg"
        },
        "transferDatetime": "2026-05-28T10:26:29Z",
        "price": null,
        "teamOld": {
            "name": "Real Madrid"
        },
        "teamNew": {
            "id": 216,
            "name": "Getafe",
            "image": "https://images.onefootball.com/icons/teams/164/216.png"
        }
    }
]
Get team transfers — CODE SNIPPETS

curl --location --request GET 'https://zylalabs.com/api/13509/onefootball+api/29931/get+team+transfers?team_id=26' --header 'Authorization: Bearer YOUR_API_KEY' 


    
Request
Returns the competitions a team takes part in.
Endpoint ID: 29932
GET https://docs.zylalabs.com/api/13509/onefootball+api/29932/get+team+competitions
INPUT PARAMETERS

Get team competitions — Endpoint Features

Object Description
team_id Required ID of the team.

Free test requests remaining: 3 of 3.


INPUT PARAMETERS

team_id
API EXAMPLE RESPONSE
JSON
[
    {
        "id": 140,
        "name": "Club Friendly Games"
    },
    {
        "id": 18,
        "name": "Copa del Rey"
    },
    {
        "id": 2955,
        "name": "FIFA Club World Cup"
    },
    {
        "id": 10,
        "name": "LaLiga"
    },
    {
        "id": 63,
        "name": "Supercopa de España"
    }
]
Get team competitions — CODE SNIPPETS

curl --location --request GET 'https://zylalabs.com/api/13509/onefootball+api/29932/get+team+competitions?team_id=26' --header 'Authorization: Bearer YOUR_API_KEY' 


    
Request
Returns the details for a transfer.......
Endpoint ID: 29933
GET https://docs.zylalabs.com/api/13509/onefootball+api/29933/get+transfer+details
INPUT PARAMETERS

Get transfer details — Endpoint Features

Object Description
transfer_id Required Transfer ID.

Free test requests remaining: 3 of 3.


INPUT PARAMETERS

transfer_id
API EXAMPLE RESPONSE
JSON
{
    "id": 43088238,
    "status": "Done deal",
    "price": "€6,000,000.00",
    "type": "Standard",
    "age": "29",
    "position": "Midfielder",
    "country": "Spain",
    "height": "187cm",
    "player": {
        "id": 221194,
        "name": "Brais Mendez",
        "image": "https://images.onefootball.com/players/180/221194.jpg"
    },
    "teamOld": {
        "id": 223,
        "name": "Real Sociedad",
        "url": "https://onefootball.com/en/team/real-sociedad-223",
        "image": "https://images.onefootball.com/icons/teams/164/223.png"
    },
    "teamNew": {
        "id": 855,
        "name": "Columbus Crew",
        "url": "https://onefootball.com/en/team/columbus-crew-855",
        "image": "https://images.onefootball.com/icons/teams/164/855.png"
    }
}
Get transfer details — CODE SNIPPETS

curl --location --request GET 'https://zylalabs.com/api/13509/onefootball+api/29933/get+transfer+details?transfer_id=43088238' --header 'Authorization: Bearer YOUR_API_KEY' 


    

API Access Key & Authentication

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 OneFootball API simply include your bearer token in the Authorization header.

Headers
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 🎉)

🚀 Enterprise Plan

Starts at
$ 10,000/Year


  • Custom Volume
  • Custom Rate Limit
  • Specialized Customer Support
  • Real-Time API Monitoring

Overview

Football matches by date, match details with lineups, statistics and events, competition standings and fixtures, team pages and squads, plus player profiles.

OneFootball API FAQs

Each endpoint returns specific football-related data, such as competition details, match fixtures, results, player profiles, and team statistics. For example, the "Get competition fixtures" endpoint provides upcoming match details, while "Get player stats" returns individual performance metrics.

Key fields vary by endpoint but generally include identifiers (id), names (name), URLs for more information, and specific attributes like scores, dates, and team details. For instance, match details include home and away team names, scores, and match status.

Response data is structured in JSON format, typically organized into arrays and objects. For example, match data includes nested objects for teams and their respective statistics, making it easy to parse and utilize in applications.

Each endpoint provides distinct information; for example, "Get match events" returns details on goals and substitutions, while "Get competition table" shows standings. This allows users to access comprehensive data on matches, teams, and players.

Users can customize requests by utilizing parameters such as competition ID, date, or team name. For example, the "Get matches by date" endpoint defaults to today but can be adjusted to retrieve matches for any specified date.

The data is sourced from OneFootball's extensive database, which aggregates information from various leagues, competitions, and matches worldwide. This ensures a wide coverage of football events and player statistics.

Typical use cases include developing sports applications, creating fantasy football platforms, or analyzing team performance. For instance, developers can use player stats to enhance user engagement in fantasy leagues.

Users can leverage the structured JSON responses to integrate football data into their applications. For example, they can display live match updates, player statistics, or competition standings dynamically based on the API responses.

General FAQs

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.

Prices are listed in USD (United States Dollar), EUR (Euro), CAD (Canadian Dollar), AUD (Australian Dollar), and GBP (British Pound). We accept all major debit and credit cards. Our payment system uses the latest security technology and is powered by Stripe, one of the world's most reliable payment companies. If you have any trouble paying by card, just contact us at [email protected]

Additionally, if you already have an active subscription in any of these currencies (USD, EUR, CAD, AUD, GBP), that currency will remain for subsequent subscriptions. You can change the currency at any time as long as you don't have any active subscriptions.
The local currency shown on the pricing page is based on the country of your IP address and is provided for reference only. The actual prices are in USD (United States Dollar). When you make a payment, the charge will appear on your card statement in USD, even if you see the equivalent amount in your local currency on our website. This means you cannot pay directly with your local currency.
Occasionally, a bank may decline the charge due to its fraud protection settings. We suggest reaching out to your bank initially to check if they are blocking our charges. Also, you can access the Billing Portal and change the card associated to make the payment. If these does not work and you need further assistance, please contact our team at [email protected]
Prices are determined by a recurring monthly or yearly subscription, depending on the chosen plan.
API calls are deducted from your plan based on successful requests. Each plan comes with a specific number of calls that you can make per month. Only successful calls, indicated by a Status 200 response, will be counted against your total. This ensures that failed or incomplete requests do not impact your monthly quota.
Zyla API Hub works on a recurring monthly subscription system. Your billing cycle will start the day you purchase one of the paid plans, and it will renew the same day of the next month. So be aware to cancel your subscription beforehand if you want to avoid future charges.
To upgrade your current subscription plan, simply go to the pricing page of the API and select the plan you want to upgrade to. The upgrade will be instant, allowing you to immediately enjoy the features of the new plan. Please note that any remaining calls from your previous plan will not be carried over to the new plan, so be aware of this when upgrading. You will be charged the full amount of the new plan.
To check how many API calls you have left for the current month, refer to the 'X-Zyla-API-Calls-Monthly-Remaining' field in the response header. For example, if your plan allows 1,000 requests per month and you've used 100, this field in the response header will indicate 900 remaining calls.

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.

The 'X-Zyla-RateLimit-Reset' header shows the number of seconds until your rate limit resets. This tells you when your request count will start fresh. For example, if it displays 3,600, it means 3,600 seconds are left until the limit resets.

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.

After 7 days, you will be charged the full amount for the plan you were subscribed to during the trial. Therefore, it's important to cancel before the trial period ends. Refund requests for forgetting to cancel on time are not accepted.
When you subscribe to an API free trial, you can make up to 50 API calls. If you wish to make additional API calls beyond this limit, the API will prompt you to perform an "Start Your Paid Plan." You can find the "Start Your Paid Plan" button in your profile under Subscription -> Choose the API you are subscribed to -> Pricing tab.
You can contact us through our chat channel to receive immediate assistance. We are always online from 8 am to 5 pm (EST). If you reach us after that time, we will get back to you as soon as possible. Additionally, you can contact us via email at [email protected]

Please have a look at our Refund Policy: https://zylalabs.com/terms#refund


Related APIs