PHPackages                             linuskohl/org-football-data-api - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [API Development](/categories/api)
4. /
5. linuskohl/org-football-data-api

ActiveLibrary[API Development](/categories/api)

linuskohl/org-football-data-api
===============================

0291PHP

Since Apr 20Pushed 9y agoCompare

[ Source](https://github.com/linuskohl/org-football-data-api)[ Packagist](https://packagist.org/packages/linuskohl/org-football-data-api)[ RSS](/packages/linuskohl-org-football-data-api/feed)WikiDiscussions master Synced 2w ago

READMEChangelogDependenciesVersions (1)Used By (0)

orgFootballDataApi
==================

[](#orgfootballdataapi)

Unofficial Football-Data.org PHP API client
Documentation available [here](http://api.football-data.org/documentation) and [here](http://api.football-data.org/docs/v1/index.html).
Able to serialize responses to custom models via JSON mapper.

[![soccer](https://camo.githubusercontent.com/f73e6f329f5c30f1ffeff0ca1a90f175f560decb9fd3528b9f683b37d0ef6cf6/68747470733a2f2f696d616765732e706578656c732e636f6d2f70686f746f732f31373539382f706578656c732d70686f746f2e6a70673f773d3132363026683d373530266175746f3d636f6d70726573732663733d74696e7973726762)](https://camo.githubusercontent.com/f73e6f329f5c30f1ffeff0ca1a90f175f560decb9fd3528b9f683b37d0ef6cf6/68747470733a2f2f696d616765732e706578656c732e636f6d2f70686f746f732f31373539382f706578656c732d70686f746f2e6a70673f773d3132363026683d373530266175746f3d636f6d70726573732663733d74696e7973726762)

Requirements
------------

[](#requirements)

- "guzzlehttp/guzzle": "^6.2"
- "netresearch/jsonmapper": "~1.1.1"

Install
-------

[](#install)

Via Composer

```
$ composer require linuskohl/org-football-data-api dev-master
```

License
-------

[](#license)

The MIT License (MIT). Please see [License File](LICENSE.md) for more information.

Documentation
-------------

[](#documentation)

### Class: \\linuskohl\\orgFootballDataApi\\Client

[](#class-linuskohlorgfootballdataapiclient)

VisibilityFunctionpublic**\_\_construct(***string* **$auth\_token=null**) : *void*
*Constructor*public**getCompetitions(***integer* **$season=null**, *bool/boolean* **$cached=true**) : *[\\linuskohl\\orgFootballDataApi\\models\\Competition](#class-linuskohlorgfootballdataapimodelscompetition)\[\]/null*public**getCompetitionsRaw(***integer* **$season=null**, *bool/boolean* **$cached=true**) : *mixed*public**getFixture(***integer* **$fixture\_id**, *integer* **$head2head=10**, *bool/boolean* **$cached=true**) : *[\\linuskohl\\orgFootballDataApi\\models\\Fixture](#class-linuskohlorgfootballdataapimodelsfixture)*
*Get fixture by id*public**getFixtureRaw(***integer* **$fixture\_id**, *integer* **$head2head=10**, *bool/boolean* **$cached=true**) : *mixed*
*Get fixture by id*public**getFixtures(***string* **$time\_frame=null**, *string\[\]* **$leagues=null**, *bool/boolean* **$cached=true**) : *[\\linuskohl\\orgFootballDataApi\\models\\Fixture](#class-linuskohlorgfootballdataapimodelsfixture)\[\]*
*Get fixtures*public**getFixturesByCompetition(***mixed* **$competition\_id**, *string* **$time\_frame=null**, *integer* **$matchday=null**, *bool/boolean* **$cached=true**) : *[\\linuskohl\\orgFootballDataApi\\models\\Fixture](#class-linuskohlorgfootballdataapimodelsfixture)\[\]*public**getFixturesByCompetitionRaw(***mixed* **$competition\_id**, *string* **$time\_frame=null**, *integer* **$matchday=null**, *bool/boolean* **$cached=true**) : *mixed*public**getFixturesByTeam(***mixed* **$team\_id**, *integer* **$season=null**, *string* **$time\_frame=null**, *string* **$venue=null**, *bool/boolean* **$cached=true**) : *[\\linuskohl\\orgFootballDataApi\\models\\Fixture](#class-linuskohlorgfootballdataapimodelsfixture)\[\]*public**getFixturesByTeamRaw(***mixed* **$team\_id**, *integer* **$season=null**, *string* **$time\_frame=null**, *string* **$venue=null**, *bool/boolean* **$cached=true**) : *mixed*public**getFixturesRaw(***string* **$time\_frame=null**, *string\[\]* **$leagues=null**, *bool/boolean* **$cached=true**) : *mixed*
*Get fixtures*public**getLeagueTable(***integer* **$competition\_id**, *\\linuskohl\\orgFootballDataApi\\unknown* **$matchday=null**) : *mixed*public**getPlayer(***integer* **$team\_id**, *bool/boolean* **$cached=true**) : *[\\linuskohl\\orgFootballDataApi\\models\\Player](#class-linuskohlorgfootballdataapimodelsplayer)\[\]*
*Get list of all players of a team*public**getPlayerRaw(***integer* **$team\_id**, *bool/boolean* **$cached=true**) : *mixed*
*Get list of all players of a team*public**getTeam(***integer* **$team\_id**, *bool/boolean* **$cached=true**) : *[\\linuskohl\\orgFootballDataApi\\models\\Team](#class-linuskohlorgfootballdataapimodelsteam)*
*Get team object*public**getTeamRaw(***integer* **$team\_id**, *bool/boolean* **$cached=true**) : *mixed*
*Get team object*public**getTeamsByCompetition(***integer* **$competition\_id**, *bool/boolean* **$cached=true**) : *[\\linuskohl\\orgFootballDataApi\\models\\Team](#class-linuskohlorgfootballdataapimodelsteam)\[\]*public**getTeamsByCompetitionRaw(***integer* **$competition\_id**, *bool/boolean* **$cached=true**) : *mixed*public**setCache(***mixed* **$cache**) : *void*protected static**generateCacheKey(***string* **$url**, *mixed* **$parameters**) : *string*
*Generate a key to cache the query*protected**get(***string* **$url**, *array/mixed\[\]* **$parameters=array()**, *bool/boolean* **$cached=true**) : *string*
*Get data from API or cache*protected**sendRequest(***string* **$url**, *mixed\[\]* **$parameters**) : *string*
*Send request to API*---

Additional Documentation
------------------------

[](#additional-documentation)

### League Codes

[](#league-codes)

League-CodeCountryLeagueBL1Germany1. BundesligaBL2Germany2. BundesligaBL3Germany3. BundesligaDFBGermanyDfb-CupPLEnglandPremiere LeagueEL1EnglandLeague OneELCEnglandChampionshipFACEnglandFA-CupSAItalySerie ASBItalySerie BPDSpainPrimera DivisionSDSpainSegunda DivisionCDRSpainCopa del ReyFL1FranceLigue 1FL2FranceLigue 2DEDNetherlandsEredivisiePPLPortugalPrimeira LigaGSLGreeceSuper LeagueCLEuropeChampions-LeagueELEuropeUEFA-CupECEuropeEuropean-Cup of NationsWCWorldWorld-Cup### Undocumented

[](#undocumented)

League-CodeCountryLeagueENLEnglandEnglish National LeagueEL2EnglandLeague TwoBSABrazilCampeonato Brasileiro da Serie A

###  Health Score

21

—

LowBetter than 18% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity8

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity41

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/2761641?v=4)[Linus Kohl](/maintainers/linuskohl)[@linuskohl](https://github.com/linuskohl)

---

Top Contributors

[![linuskohl](https://avatars.githubusercontent.com/u/2761641?v=4)](https://github.com/linuskohl "linuskohl (24 commits)")

---

Tags

apiapi-clientfootballpackagistphpsoccer

### Embed Badge

![Health badge](/badges/linuskohl-org-football-data-api/health.svg)

```
[![Health](https://phpackages.com/badges/linuskohl-org-football-data-api/health.svg)](https://phpackages.com/packages/linuskohl-org-football-data-api)
```

###  Alternatives

[exsyst/swagger

A php library to manipulate Swagger specifications

35816.3M7](/packages/exsyst-swagger)[hubspot/api-client

Hubspot API client

24015.5M18](/packages/hubspot-api-client)[pocketmine/bedrock-protocol

An implementation of the Minecraft: Bedrock Edition protocol in PHP

172437.8k11](/packages/pocketmine-bedrock-protocol)[botman/driver-telegram

Telegram driver for BotMan

94452.6k6](/packages/botman-driver-telegram)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)