football API Documentation

Simple REST API. Pass your API key as a query parameter — no headers required.

Base URL: https://live-football-api.com/api/v1

Authentication

Add api_key to every request URL. You can get a key by creating a free account.

https://live-football-api.com/api/v1/matches?api_key=YOUR_KEY&date=2026-07-03

Do not expose your API key in public client-side code or public repos.

Credits

Each API call consumes credits from your balance. Credits never expire. New accounts get 100 free credits.

Endpoint	Cost
GET /matches	1 credit per call
GET /live_match_details	1 credit per call
GET /lineups	1 credit per call
GET /h2h	1 credit per call
GET /injuries	1 credit per call
GET /officials	1 credit per call
GET /leagues	1 credit per call
GET /league	1 credit per call
GET /league_standings	1 credit per call
GET /league_fixtures	1 credit per call
GET /team_matches	1 credit per call
GET /team_squad	1 credit per call
GET /team_standings	1 credit per call
GET /player	1 credit per call
GET /player_matches	1 credit per call
GET /team_search	1 credit per call
GET /player_search	1 credit per call
POST /webhook/register	Free
GET /webhook/register	Free
DELETE /webhook/register	Free

Errors

All errors return JSON with a code and message:

Code	Meaning
400	Bad request — missing or invalid parameter
401	API key missing or invalid
403	Access denied — insufficient credits, daily limit exceeded, or inactive account
429	Insufficient credits
500	Database error
503	Upstream data source unavailable — retry after a few seconds

{
  "success": false,
  "message": "Access denied. Possible reasons: Invalid key, insufficient credits, daily limit exceeded, or inactive account.",
  "timestamp": "2026-07-03 14:22:01"
}

GET /matches

Returns football matches for a given date. Optionally translate team and competition names.

Parameters

Parameter	Type	Required	Description
api_key	string	Yes	Your API key
date	string	No	Match date in `YYYY-MM-DD` format
lang	string	No	Response language: `en` `tr` `de` `ru`

Example request

GET https://live-football-api.com/api/v1/matches?api_key=YOUR_KEY&date=2026-07-03&lang=en

Response

{
  "success": true,
  "credits_remaining": 4999,
  "data": {
    "date": "2026-07-03",
    "language": "en",
    "timezone": "UTC",
    "matches": [
      {
        "id": "lfa4phmwb3bhclg7aqht1ajcwk",
        "league": {
          "id": "lfa-premier-league",
          "name": "Premier League",
          "country": "England"
        },
        "kickoff": "14:00",
        "status": {
          "status": "live",
          "display": "73'",
          "is_live": true,
          "state": "inPlay"
        },
        "home": {
          "id": "lfa-man-city",
          "name": "Manchester City",
          "logo": "https://live-football-api.com/teams/lfa-man-city.png",
          "score": 2
        },
        "away": {
          "id": "lfa-arsenal",
          "name": "Arsenal",
          "logo": "https://live-football-api.com/teams/lfa-arsenal.png",
          "score": 1
        },
        "halftime": { "home": 1, "away": 0 },
        "tv_broadcast": true,
        "penalty": { "home": null, "away": null }
      }
    ]
  },
  "timestamp": "2026-07-03 14:22:01"
}

tv_broadcast — true if the match is scheduled for TV broadcast (no channel names yet). penalty — penalty shoot-out score, null unless the match went to penalties.

GET /live_match_details

Returns real-time match data: event timeline (goals, cards, substitutions) and match statistics (possession, shots, corners, etc.).

Parameters

Parameter	Type	Required	Description
api_key	string	Yes	Your API key
match_id	string	Yes	Match ID from `/matches`
lang	string	No	Response language: `en` `tr` `de` `ru`

Example request

GET https://live-football-api.com/api/v1/live_match_details?api_key=YOUR_KEY&match_id=lfa4phmwb3bhclg7aqht1ajcwk&lang=en

Response

{
  "success": true,
  "credits_remaining": 4998,
  "data": {
    "match_id": "lfa4phmwb3bhclg7aqht1ajcwk",
    "last_updated": "2026-07-03 14:22:01 UTC",
    "header": {
      "home": {
        "name": "Manchester City",
        "id": "lfa-man-city",
        "logo": "https://live-football-api.com/teams/lfa-man-city.png",
        "score": "2"
      },
      "away": {
        "name": "Arsenal",
        "id": "lfa-arsenal",
        "logo": "https://live-football-api.com/teams/lfa-arsenal.png",
        "score": "1"
      },
      "status": { "display": "", "is_live": true, "is_postponed": 0, "minute": "73", "state": "inPlay" }
    },
    "events": [
      {
        "time": "23",
        "type": "Goal",
        "side": "home",
        "detail": {
          "player": { "name": "Haaland", "id": "lfa-haaland", "image": "https://live-football-api.com/people/lfa-haaland.png" },
          "score": "1-0"
        }
      },
      {
        "time": "65",
        "type": "Yellow Card",
        "side": "away",
        "detail": {
          "player": { "name": "Rice", "id": "lfa-rice", "image": "https://live-football-api.com/people/lfa-rice.png" }
        }
      }
    ],
    "stats": [
      { "label": "Possession", "home": "62%", "away": "38%" },
      { "label": "Shots",      "home": "14",  "away": "6"   },
      { "label": "Corners",    "home": "7",   "away": "3"   }
    ],
    "csb_url": "https://live-football-api.com/api/v1/csb?token=eyJhbGci...&matchid=lfa4phmwb3bhclg7aqht1ajcwk&lang=en",
    "venue": { "name": "Etihad Stadium", "capacity": 53400 },
    "referee": "M. Oliver",
    "tv_channels": ["beIN SPORTS 1"],
    "player_of_the_match": { "name": "Haaland", "id": "lfa-haaland", "image": "https://live-football-api.com/people/lfa-haaland.png", "rating": 8.7 }
  },
  "timestamp": "2026-07-03 14:22:01"
}

venue, referee, tv_channels (actual channel names) and player_of_the_match are new. Events may also include is_penalty / is_second_yellow flags inside detail when relevant.

csb_url — Ready-to-use iframe URL for the live match Centre Stage Board visualization. Embed it directly: <iframe src="csb_url" width="636" height="400" frameborder="0"></iframe>
Returns null if the match has no active CSB feed (e.g. pre-match or unsupported competition).

GET /csb

Returns a live match Centre Stage Board (CSB) visualization as an HTML page — designed to be embedded in an <iframe>. The csb_url field in the /live_match_details response already contains a ready-to-use URL with a pre-fetched token; you do not need to call this endpoint manually in most cases.

Parameters

Parameter	Type	Required	Description
token	string	Yes	JWT visualization token (provided ready-to-use inside `csb_url` from the live_match_details response).
matchid	string	Yes	Match ID in `lfa` format (same as the `id` field from /matches).
lang	string	No	Response language: `en` `tr` `de` `ru`

Example request

<iframe
  src="https://live-football-api.com/api/v1/csb?token=TOKEN&matchid=lfa4phmwb3bhclg7aqht1ajcwk&lang=en"
  width="636"
  height="400"
  frameborder="0"
  allowtransparency="true"
></iframe>

The CSB token is time-limited (typically valid for 4 hours). Use the csb_url from a fresh /live_match_details call to always get a valid token. Do not cache or hardcode tokens.

GET /lineups

Returns starting XI, substitutes and coach for both teams. Available approximately 1 hour before kickoff.

Parameters

Parameter	Type	Required	Description
api_key	string	Yes	Your API key
match_id	string	Yes	Match ID from `/matches`
lang	string	No	Response language: `en` `tr` `de` `ru`

Example request

GET https://live-football-api.com/api/v1/lineups?api_key=YOUR_KEY&match_id=lfa4phmwb3bhclg7aqht1ajcwk&lang=en

Response

{
  "success": true,
  "credits_remaining": 4997,
  "data": {
    "match_id": "lfa4phmwb3bhclg7aqht1ajcwk",
    "home": {
      "starting": [
        { "id": "lfa-ederson", "name": "Ederson", "image": "https://live-football-api.com/people/lfa-ederson.png", "number": "31", "position": "Goalkeeper", "rating": 6.8 },
        { "id": "lfa-haaland", "name": "Haaland", "image": "https://live-football-api.com/people/lfa-haaland.png", "number": "9",  "position": "Forward",   "rating": 8.7 }
      ],
      "subs": [
        { "id": "lfa-bernardo", "name": "Bernardo Silva", "image": "https://live-football-api.com/people/lfa-bernardo.png", "number": "20", "position": "Midfielder", "rating": null }
      ],
      "coach": { "id": "lfa-guardiola", "name": "Pep Guardiola", "image": "https://live-football-api.com/people/lfa-guardiola.png" }
    },
    "away": {
      "starting": [
        { "id": "lfa-raya", "name": "Raya", "image": "https://live-football-api.com/people/lfa-raya.png", "number": "1", "position": "Goalkeeper", "rating": 6.5 }
      ],
      "subs": [],
      "coach": { "id": "lfa-arteta", "name": "Mikel Arteta", "image": "https://live-football-api.com/people/lfa-arteta.png" }
    },
    "formation": { "home": 433, "away": 442 },
    "is_projected": false
  },
  "timestamp": "2026-07-03 14:22:01"
}

Each player now also carries number, position and rating. Top-level formation and is_projected (true = provisional lineup before kickoff) are new.

GET /h2h

Returns head-to-head historical results between the two teams in a given match.

Parameters

Parameter	Type	Required	Description
api_key	string	Yes	Your API key
match_id	string	Yes	Match ID from `/matches`
lang	string	No	Response language: `en` `tr` `de` `ru`

Example request

GET https://live-football-api.com/api/v1/h2h?api_key=YOUR_KEY&match_id=lfa4phmwb3bhclg7aqht1ajcwk&lang=en

Response

{
  "success": true,
  "credits_remaining": 4996,
  "data": {
    "match_id": "lfa4phmwb3bhclg7aqht1ajcwk",
    "home_form": [
      {
        "date": "2026-06-14",
        "home": { "id": "lfa-man-city", "name": "Manchester City", "logo": "https://live-football-api.com/teams/lfa-man-city.png" },
        "away": { "id": "lfa-chelsea",  "name": "Chelsea",         "logo": "https://live-football-api.com/teams/lfa-chelsea.png" },
        "score": "3-1"
      }
    ],
    "away_form": [ ],
    "h2h": [
      {
        "date": "2025-09-22",
        "home": { "id": "lfa-man-city", "name": "Manchester City", "logo": "https://live-football-api.com/teams/lfa-man-city.png" },
        "away": { "id": "lfa-arsenal",  "name": "Arsenal",         "logo": "https://live-football-api.com/teams/lfa-arsenal.png" },
        "score": "2-1"
      }
    ],
    "h2h_summary": { "home_wins": 8, "away_wins": 6, "draws": 4 }
  },
  "timestamp": "2026-07-03 14:22:01"
}

h2h_summary is new — aggregate win/draw counts for the two teams, in addition to the match-by-match lists.

GET /injuries

Returns confirmed injuries and suspensions for both squads ahead of a match.

Parameters

Parameter	Type	Required	Description
api_key	string	Yes	Your API key
match_id	string	Yes	Match ID from `/matches`
lang	string	No	Response language: `en` `tr` `de` `ru`

Example request

GET https://live-football-api.com/api/v1/injuries?api_key=YOUR_KEY&match_id=lfa4phmwb3bhclg7aqht1ajcwk&lang=en

Response

{
  "success": true,
  "credits_remaining": 4995,
  "data": {
    "match_id": "lfa4phmwb3bhclg7aqht1ajcwk",
    "injuries": {
      "home": [
        {
          "id": "lfa-de-bruyne",
          "name": "Kevin De Bruyne",
          "image": "https://live-football-api.com/people/lfa-de-bruyne.png",
          "position": "Midfielder",
          "status": "Hamstring Injury",
          "stats": { "appearence": 12, "assists": 6, "goals": 2, "redCards": 0, "yellowCards": 1 }
        }
      ],
      "away": [
        { "id": "lfa-zinchenko", "name": "Oleksandr Zinchenko", "image": "https://live-football-api.com/people/lfa-zinchenko.png", "position": "Defender", "status": "Suspended", "stats": null }
      ]
    }
  },
  "timestamp": "2026-07-03 14:22:01"
}

Each player now also carries stats (appearances/goals/assists/cards this season) when available, null otherwise.

GET /officials

Returns the referee and assistant officials assigned to a match.

Parameters

Parameter	Type	Required	Description
api_key	string	Yes	Your API key
match_id	string	Yes	Match ID from `/matches`
lang	string	No	Response language: `en` `tr` `de` `ru`

Example request

GET https://live-football-api.com/api/v1/officials?api_key=YOUR_KEY&match_id=lfa4phmwb3bhclg7aqht1ajcwk

Response

{
  "success": true,
  "credits_remaining": 4994,
  "data": {
    "match_id": "lfa4phmwb3bhclg7aqht1ajcwk",
    "officials": [
      { "id": "8d319822-2432-4da3-7bcb-ca5c11421394", "name": "Michael Oliver", "role": "Main" },
      { "id": "6c998fdc-ca49-69c3-2488-347671830e3a", "name": "Stuart Burt",    "role": "Lineman 1" },
      { "id": "6a528c78-5157-c275-9d86-ca7ed7ff21ac", "name": "Simon Long",     "role": "Lineman 2" },
      { "id": "e6e57850-918d-c5ef-9bc0-e8b43c2b8e88", "name": "Anthony Taylor","role": "Fourth official" },
      { "id": "4748a374-2d55-ae66-642e-8e9e05fb566c", "name": "Graham Scott",  "role": "VAR" }
    ]
  },
  "timestamp": "2026-07-03 14:22:01"
}

GET /leagues

Returns all available leagues grouped by country, sorted alphabetically.

Parameters

Parameter	Type	Required	Description
api_key	string	Yes	Your API key
lang	string	No	Response language: `en` `tr` `de` `ru`

Example request

GET https://live-football-api.com/api/v1/leagues?api_key=YOUR_KEY&lang=en

Response

{
  "success": true,
  "credits_remaining": 4993,
  "data": {
    "language": "en",
    "total_countries": 45,
    "data": [
      {
        "country": "England",
        "leagues": [
          { "id": "lfa-premier-league",    "name": "Premier League" },
          { "id": "lfa-championship",      "name": "Championship" },
          { "id": "lfa-league-one",        "name": "League One" }
        ]
      },
      {
        "country": "Spain",
        "leagues": [
          { "id": "lfa-la-liga",   "name": "La Liga" },
          { "id": "lfa-segunda",   "name": "Segunda División" }
        ]
      }
    ]
  },
  "timestamp": "2026-07-03 14:22:01"
}

GET /league

Returns detailed information about a single league including season, teams and logo.

Parameters

Parameter	Type	Required	Description
api_key	string	Yes	Your API key
league_id	string	Yes	League ID from `/leagues`
lang	string	No	Response language: `en` `tr` `de` `ru`

Example request

GET https://live-football-api.com/api/v1/league?api_key=YOUR_KEY&league_id=lfa-premier-league&lang=en

GET /league_standings

Returns the current standings table for a league. Supports multiple groups (e.g. Champions League group stage).

Parameters

Parameter	Type	Required	Description
api_key	string	Yes	Your API key
league_id	string	Yes	League ID from `/leagues`
season	string	No	Season identifier e.g. `2025` or `2025-2026`. Omit for current season.
lang	string	No	Response language: `en` `tr` `de` `ru`

Example request

GET https://live-football-api.com/api/v1/league_standings?api_key=YOUR_KEY&league_id=lfa-premier-league&season=2024/2025&lang=en

Response

{
  "success": true,
  "credits_remaining": 4992,
  "data": {
    "league_id": "lfa-premier-league",
    "season": "2024/2025",
    "available_seasons": ["2024/2025", "2023/2024", "2022/2023"],
    "timezone": "UTC",
    "standings": [
      {
        "title": "Premier League",
        "table": [
          {
            "rank": 1,
            "team": {
              "id": "lfa-liverpool",
              "name": "Liverpool",
              "logo": "https://live-football-api.com/teams/lfa-liverpool.png"
            },
            "played": 38, "won": 28, "drawn": 6, "lost": 4,
            "goals_for": 86, "goals_against": 41,
            "goal_diff": 45, "points": 90,
            "form": "WWDWL",
            "zone": { "name": "Champions League", "color": "#02206B" }
          },
          {
            "rank": 2,
            "team": {
              "id": "lfa-man-city",
              "name": "Manchester City",
              "logo": "https://live-football-api.com/teams/lfa-man-city.png"
            },
            "played": 38, "won": 24, "drawn": 7, "lost": 7,
            "goals_for": 78, "goals_against": 52,
            "goal_diff": 26, "points": 79,
            "form": "WDWWW",
            "zone": { "name": "Champions League", "color": "#02206B" }
          }
        ]
      }
    ],
    "home_standings": [ { "title": "Premier League", "table": [ ] } ],
    "away_standings": [ { "title": "Premier League", "table": [ ] } ]
  },
  "timestamp": "2026-07-03 14:22:01"
}

Each row now also carries form (last-5 results, e.g. "WWDWL") and zone (qualification/relegation zone, if any). New top-level home_standings / away_standings give the same table split by home-only and away-only results. Note: numeric fields (rank, played, points, etc.) are now JSON numbers rather than strings.

GET /league_fixtures

Returns the full match schedule for a league, grouped week by week, with scores for played matches and kickoff times for upcoming ones.

Parameters

Parameter	Type	Required	Description
api_key	string	Yes	Your API key
league_id	string	Yes	League ID from `/leagues`
season	string	No	Season identifier e.g. `2025` or `2025-2026`. Omit for current season.
week	string	No	Filter to a single gameweek/round name, e.g. `1`. Omit to get all weeks.
lang	string	No	Response language: `en` `tr` `de` `ru`

Example request

GET https://live-football-api.com/api/v1/league_fixtures?api_key=YOUR_KEY&league_id=lfa-super-lig&season=2025/2026&week=1&lang=tr

Response

{
  "success": true,
  "credits_remaining": 4991,
  "data": {
    "league_id": "lfa-super-lig",
    "league_name": "Trendyol Süper Lig",
    "season": "2025/2026",
    "available_seasons": ["2025/2026", "2024/2025", "2023/2024"],
    "timezone": "UTC",
    "weeks": [
      {
        "week": "1",
        "matches": [
          {
            "id": "lfa-c5b95lue06z36lha2ueniwsgk",
            "league": { "id": "lfa-super-lig", "name": "Trendyol Süper Lig" },
            "round": "Adnan Süvari Sezonu",
            "date": "2026-08-14",
            "kickoff": "18:30",
            "status": { "status": "finished", "display": "MS", "is_live": false, "state": "postGame" },
            "home": {
              "id": "lfa-esa748l653sss1wurz5ps3228",
              "name": "Galatasaray",
              "logo": "https://live-football-api.com/teams/lfa-esa748l653sss1wurz5ps3228.png",
              "score": "2"
            },
            "away": {
              "id": "lfa-eg0cqg1u8zz85ma9nzk0cijv",
              "name": "Çorum FK",
              "logo": "https://live-football-api.com/teams/lfa-eg0cqg1u8zz85ma9nzk0cijv.png",
              "score": "2"
            },
            "halftime": { "home": 0, "away": 0 },
            "penalty": { "home": null, "away": null }
          }
        ]
      }
    ],
    "stale": false
  },
  "timestamp": "2026-08-31 12:00:00"
}

GET /team_matches

Returns a team's fixtures and results for a season — both past results and upcoming matches.

Parameters

Parameter	Type	Required	Description
api_key	string	Yes	Your API key
team_id	string	Yes	Team ID from match data
season	string	No	Season identifier e.g. `2025` or `2025-2026`. Omit for current season.
lang	string	No	Response language: `en` `tr` `de` `ru`

Example request

GET https://live-football-api.com/api/v1/team_matches?api_key=YOUR_KEY&team_id=lfa-man-city&season=2024/2025&lang=en

Response

{
  "success": true,
  "credits_remaining": 4991,
  "data": {
    "team_id": "lfa-man-city",
    "team_logo": "https://live-football-api.com/teams/lfa-man-city.png",
    "season": "2024/2025",
    "available_seasons": ["2024/2025", "2023/2024", "2022/2023"],
    "timezone": "UTC",
    "matches": [
      {
        "id": "lfa4phmwb3bhclg7aqht1ajcwk",
        "date": "2025-08-17 14:00:00",
        "timestamp": 1755439200,
        "league": { "id": "lfa-premier-league", "name": "Premier League", "country": "England" },
        "status": "FT",
        "home": { "id": "lfa-man-city", "name": "Manchester City", "logo": "https://live-football-api.com/teams/lfa-man-city.png", "score": 2 },
        "away": { "id": "lfa-chelsea",  "name": "Chelsea",          "logo": "https://live-football-api.com/teams/lfa-chelsea.png",  "score": 0 }
      }
    ]
  },
  "timestamp": "2026-07-03 14:22:01"
}

GET /team_squad

Returns the full squad list for a team with player positions and shirt numbers.

Parameters

Parameter	Type	Required	Description
api_key	string	Yes	Your API key
team_id	string	Yes	Team ID from match data
season	string	No	Season identifier e.g. `2025` or `2025-2026`. Omit for current season.
lang	string	No	Response language: `en` `tr` `de` `ru`

Example request

GET https://live-football-api.com/api/v1/team_squad?api_key=YOUR_KEY&team_id=lfa-man-city&season=2024/2025

Response

{
  "success": true,
  "credits_remaining": 4990,
  "data": {
    "team_id": "lfa-man-city",
    "team_logo": "https://live-football-api.com/teams/lfa-man-city.png",
    "season": "2024/2025",
    "available_seasons": ["2024/2025", "2023/2024", "2022/2023"],
    "timezone": "UTC",
    "squad": [
      {
        "id": "lfa-haaland",
        "name": "Erling Haaland",
        "image": "https://live-football-api.com/people/lfa-haaland.png",
        "number": "9",
        "position": "Forward",
        "age": 25,
        "country": "Norway",
        "stats": { "matches": 34, "goals": 27, "assists": 5 },
        "yellow_cards": 2,
        "red_cards": 0
      }
    ],
    "coaches": [
      { "id": "lfa-guardiola", "name": "Pep Guardiola", "image": "https://live-football-api.com/people/lfa-guardiola.png" }
    ]
  },
  "timestamp": "2026-07-03 14:22:01"
}

Each player now also carries yellow_cards / red_cards for the season. New top-level coaches lists the team's coaching staff.

GET /team_standings

Returns a team's current position in its league(s) for the season.

Parameters

Parameter	Type	Required	Description
api_key	string	Yes	Your API key
team_id	string	Yes	Team ID from match data
lang	string	No	Response language: `en` `tr` `de` `ru`

Example request

GET https://live-football-api.com/api/v1/team_standings?api_key=YOUR_KEY&team_id=lfa-man-city&lang=en

Response

{
  "success": true,
  "credits_remaining": 4989,
  "data": {
    "team_id": "lfa-man-city",
    "season": "2024/2025",
    "available_seasons": ["2024/2025", "2023/2024"],
    "timezone": "UTC",
    "standings": [
      {
        "league": "Premier League",
        "table": [
          {
            "rank": 2,
            "team": { "id": "lfa-man-city", "name": "Manchester City", "logo": "https://live-football-api.com/teams/lfa-man-city.png" },
            "played": 38, "won": 24, "drawn": 7, "lost": 7,
            "goals_for": 78, "goals_against": 52, "goal_diff": 26, "points": 79,
            "form": "WDWWW",
            "zone": { "name": "Champions League", "color": "#02206B" }
          }
        ]
      }
    ]
  },
  "timestamp": "2026-07-03 14:22:01"
}

GET /team_search

Searches for teams by name. Returns matching teams with their IDs and logos.

Parameters

Parameter	Type	Required	Description
api_key	string	Yes	Your API key
q	string	Yes	Search keywords (team or player name)
lang	string	No	Response language: `en` `tr` `de` `ru`

Example request

GET https://live-football-api.com/api/v1/team_search?api_key=YOUR_KEY&q=galatasaray

Response

{
  "success": true,
  "credits_remaining": 4990,
  "data": {
    "keywords": "galatasaray",
    "total": 3,
    "teams": [
      {
        "id": "lfa-galatasaray",
        "name": "Galatasaray",
        "logo": "https://live-football-api.com/teams/lfa-galatasaray.png",
        "country": "Turkey"
      },
      {
        "id": "lfa-galatasaray-u19",
        "name": "Galatasaray U19",
        "logo": "https://live-football-api.com/teams/lfa-galatasaray-u19.png",
        "country": "Turkey"
      }
    ]
  },
  "timestamp": "2026-07-03 14:22:01"
}

Each result now also carries country (the team's/player's nationality area). This search also no longer 500s on famous single-word surnames ("messi", "ronaldo", "kane") like the previous provider did.

GET /player

Returns a player's profile (bio, position, market value) plus their full club and international career history.

Parameters

Parameter	Type	Required	Description
api_key	string	Yes	Your API key
player_id	string	Yes	Player ID, as returned by `/player_search`
lang	string	No	Response language: `en` `tr` `de` `ru`

Example request

GET https://live-football-api.com/api/v1/player?api_key=YOUR_KEY&player_id=lfa-haaland&lang=en

Response

{
  "success": true,
  "credits_remaining": 4988,
  "data": {
    "player_id": "lfa-haaland",
    "name": "E. Haaland",
    "first_name": "Erling",
    "last_name": "Haaland",
    "photo": "https://live-football-api.com/people/lfa-haaland.png",
    "position": "Forward",
    "nationality": "Norway",
    "birthdate": "2000-07-21",
    "height": "195 cm",
    "weight": "88 kg",
    "foot": "Left",
    "shirt_number": 9,
    "market_value": "180.000.000€",
    "current_team": { "id": "lfa-man-city", "name": "Manchester City", "logo": "https://live-football-api.com/teams/lfa-man-city.png" },
    "clubs_career": [
      {
        "team": { "id": "lfa-man-city", "name": "Manchester City", "logo": "https://live-football-api.com/teams/lfa-man-city.png" },
        "date_start": "2022-07-01",
        "is_loaned": false,
        "seasons": [
          {
            "name": "2024/2025",
            "competitions": [
              { "league": { "id": "lfa-premier-league", "name": "Premier League" }, "appearances": 34, "goals": 27, "assists": 5, "yellow_cards": 2, "red_cards": 0 }
            ]
          }
        ]
      }
    ],
    "internationals_career": [
      {
        "team": { "id": "lfa-norway", "name": "Norway", "logo": "https://live-football-api.com/teams/lfa-norway.png" },
        "date_start": "2019-09-05",
        "is_loaned": false,
        "seasons": []
      }
    ]
  },
  "timestamp": "2026-07-03 14:22:01"
}

GET /player_matches

Returns a player's match-by-match log (goals, assists, cards, starts) for one team and season.

Parameters

Parameter	Type	Required	Description
api_key	string	Yes	Your API key
player_id	string	Yes	Player ID, as returned by `/player_search`
team_id	string	No	Team ID the player represented, as returned in `current_team.id` / `clubs_career[].team.id` from `/player`. Defaults to their current team.
season	string	No	Season label (e.g. "2024/2025"), as returned in `clubs_career[].seasons[].name` from `/player`. Defaults to the most recent season with actual appearances for that team.
lang	string	No	Response language: `en` `tr` `de` `ru`

Example request

GET https://live-football-api.com/api/v1/player_matches?api_key=YOUR_KEY&player_id=lfa-haaland&lang=en

Response

{
  "success": true,
  "credits_remaining": 4987,
  "data": {
    "player_id": "lfa-haaland",
    "team_id": "lfa-man-city",
    "team_name": "Manchester City",
    "season": "2024/2025",
    "competitions": [
      {
        "league": { "id": "lfa-premier-league", "name": "Premier League" },
        "matches": [
          {
            "id": "lfa4phmwb3bhclg7aqht1ajcwk",
            "date": "2025-08-17 14:00:00",
            "is_home": true,
            "opponent": { "id": "lfa-chelsea", "name": "Chelsea", "logo": "https://live-football-api.com/teams/lfa-chelsea.png" },
            "score": "2-0",
            "goals": 1,
            "assists": 0,
            "yellow_card": false,
            "second_yellow_card": false,
            "red_card": false,
            "started": true
          }
        ]
      }
    ]
  },
  "timestamp": "2026-07-03 14:22:01"
}

If team_id/season are omitted, the endpoint automatically picks the most recent team+season where the player actually made an appearance (skipping season entries with zero matches, e.g. right after a transfer).

GET /player_search

Searches for players by name. Returns matching players with their IDs and photos.

Parameters

Parameter	Type	Required	Description
api_key	string	Yes	Your API key
q	string	Yes	Search keywords (team or player name)
lang	string	No	Response language: `en` `tr` `de` `ru`

Example request

GET https://live-football-api.com/api/v1/player_search?api_key=YOUR_KEY&q=mbappe

Response

{
  "success": true,
  "credits_remaining": 4989,
  "data": {
    "keywords": "mbappe",
    "total": 2,
    "players": [
      {
        "id": "lfa-k-mbappe",
        "name": "K. Mbappe",
        "photo": "https://live-football-api.com/people/lfa-k-mbappe.png",
        "country": "France"
      },
      {
        "id": "lfa-e-mbappe",
        "name": "E. Mbappe",
        "photo": "https://live-football-api.com/people/lfa-e-mbappe.png",
        "country": "France"
      }
    ]
  },
  "timestamp": "2026-07-03 14:22:01"
}

POST /webhook/register

Register a URL to receive a real-time push notification whenever a goal is scored in a live match. Registering is free. Each delivered goal notification costs 1 credit.

Webhooks are delivered via HTTP POST. Your endpoint must return a 2xx response within 10 seconds or the delivery is retried up to 3 times.

⚠️ Important Security Notice Webhook notifications are sent from our system via the IP address 45.94.4.69. For added security, you can restrict incoming requests to your webhook endpoint on your server (at the firewall level) to only allow this IP address.

Parameters (POST body)

Parameter	Type	Required	Description
api_key	string	Yes	Your API key
webhook_url	string	Yes	Your callback URL (must be HTTPS)
label	string	No	Optional label to identify this webhook

Example request

POST https://live-football-api.com/api/v1/webhook/register?api_key=YOUR_KEY
Content-Type: application/json

{
  "webhook_url": "https://yourapp.com/webhooks/football",
  "label": "my server"
}

Response

{
  "success": true,
  "data": {
    "id": 1,
    "webhook_url": "https://yourapp.com/webhooks/football",
    "label": "my server",
    "is_active": true,
    "message": "Webhook registered. You will be charged 1 credit per goal notification."
  }
}

GET /webhook/register

Returns all webhook subscriptions registered to your account. This call is free.

Parameters

Parameter	Type	Required	Description
api_key	string	Yes	Your API key

Example request

GET https://live-football-api.com/api/v1/webhook/register?api_key=YOUR_KEY

Response

{
  "success": true,
  "data": {
    "webhooks": [
      {
        "id": 1,
        "webhook_url": "https://yourapp.com/webhooks/football",
        "label": "my server",
        "is_active": true,
        "created_at": "2026-07-04 12:00:00"
      }
    ],
    "total": 1
  }
}

DELETE /webhook/register

Permanently removes a webhook subscription. This call is free.

Parameters

Parameter	Type	Required	Description
api_key	string	Yes	Your API key
id	integer	Yes	Webhook ID to delete (from the list response)

Example request

DELETE https://live-football-api.com/api/v1/webhook/register?api_key=YOUR_KEY&id=1

Response

{
  "success": true,
  "data": {
    "message": "Webhook deleted successfully."
  }
}

Payload Examples

Your registered URL will receive a POST request with a JSON body every time a goal is scored — this is the only event type sent.

Goal Event

{
  "event": "goal",
  "match_id": "lfa4phmwb3bhclg7aqht1ajcwk",
  "timestamp": "2026-07-03T14:46:00Z",
  "data": {
    "minute": 46,
    "team": "home",
    "player": "Erling Haaland",
    "assist": "Kevin De Bruyne",
    "score": { "home": 3, "away": 1 }
  }
}

Goals are currently the only event type this API sends — there is no card, kickoff or fulltime event, and no event_types parameter to configure (registration only takes webhook_url and an optional label).