PHPackages                             mapado/php-sdk - 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. mapado/php-sdk

AbandonedArchivedLibrary

mapado/php-sdk
==============

PHP SDK for Mapado API v2

v0.16.0(5y ago)0835[1 issues](https://github.com/mapado/php-sdk/issues)[1 PRs](https://github.com/mapado/php-sdk/pulls)MITPHP

Since Dec 15Pushed 5y ago12 watchersCompare

[ Source](https://github.com/mapado/php-sdk)[ Packagist](https://packagist.org/packages/mapado/php-sdk)[ RSS](/packages/mapado-php-sdk/feed)WikiDiscussions master Synced 1mo ago

READMEChangelogDependencies (2)Versions (25)Used By (0)

PHP SDK for Mapado API [![Build Status](https://camo.githubusercontent.com/ed7d95901bdf9d9f30a464971095f7b8afa5c6976cab2f9c52f7388165af3999/68747470733a2f2f7472617669732d63692e6f72672f6d617061646f2f7068702d73646b2e7376673f6272616e63683d6d6173746572)](https://travis-ci.org/mapado/php-sdk) [![StyleCI](https://camo.githubusercontent.com/b6794cf1d3d9eafa0d8797f134bdca6a636e1c4ab9de60851f6f8a1c22d77247/68747470733a2f2f7374796c6563692e696f2f7265706f732f32383033383236372f736869656c64)](https://styleci.io/repos/28038267)
======================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================

[](#php-sdk-for-mapado-api--)

⚠ Work in progress ⚠

This SDK targets version 2 of mapado api. If you are looking for the version 1, you can refer to [the old documentation](https://github.com/mapado/php-sdk/tree/api-v1)

Installation
------------

[](#installation)

Install with [composer](http://getcomposer.org):

```
composer require "mapado/php-sdk"

```

This SDK leverages the power of our [rest-client-sdk](https://github.com/mapado/rest-client-sdk).

Usage
-----

[](#usage)

### Get a token

[](#get-a-token)

### Refresh a token

[](#refresh-a-token)

### Create a client

[](#create-a-client)

### Activities

[](#activities)

```
use Mapado\Sdk\Entity\Activity;

$activities = $client->getRepository(Activity::class)->findBy(['q' => 'transbordeur', latlng => '45.468,4.263']);
$activity = $client->getRepository(Activity::class)->findOne('63e4b024-6f08-43d3-a73b-634a306bc6c6');
```

Will return an MapadoList or an instance of [Activity](https://github.com/mapado/php-sdk/blob/master/src/Model/Activity.php)

#### Program

[](#program)

If an activity contains a program, you can get it by doing this call

```
$activityList = $client->getRepository(Activity::class)->findProgramFor('villeurbanne--transbordeur');
```

Will return an MapadoList or an instance of [Activity](https://github.com/mapado/php-sdk/blob/master/src/Model/Activity.php)

### Users

[](#users)

```
use Mapado\Sdk\Entity\User;

$me = $client->getRepository(User::class)->me();
$user = $client->getRepository(User::class)->findOne('63e4b024-6f08-43d3-a73b-634a306bc6c6');
```

Will return an instance of [User](https://github.com/mapado/php-sdk/blob/master/src/Model/User.php)

#### User Lists

[](#user-lists)

### List objects

[](#list-objects)

Lists results will be contained in a [MapadoList](https://github.com/mapado/php-sdk/blob/master/src/Model/MapadoList.php) object. The list object is traversable (you can iterate on it with a foreach), and may contains some informations like totalhits, page, etc.

### Other calls

[](#other-calls)

Every endpoint listed in our documentation *should* be available like the one atop. If a endpoint is missing, please open an issue on github

###  Health Score

31

—

LowBetter than 68% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity14

Limited adoption so far

Community16

Small or concentrated contributor base

Maturity63

Established project with proven stability

 Bus Factor1

Top contributor holds 78.5% 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.

###  Release Activity

Cadence

Every ~98 days

Recently: every ~420 days

Total

22

Last Release

2106d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/3277986d0e1f93c7e8a58fdaf1b52e3f5a1588e73dfa298d33aafb1ebbde5ef2?d=identicon)[jdeniau](/maintainers/jdeniau)

---

Top Contributors

[![jdeniau](https://avatars.githubusercontent.com/u/1398469?v=4)](https://github.com/jdeniau "jdeniau (84 commits)")[![thibaudMorand](https://avatars.githubusercontent.com/u/40755296?v=4)](https://github.com/thibaudMorand "thibaudMorand (12 commits)")[![badaz](https://avatars.githubusercontent.com/u/5735255?v=4)](https://github.com/badaz "badaz (5 commits)")[![jnieuviarts](https://avatars.githubusercontent.com/u/2795427?v=4)](https://github.com/jnieuviarts "jnieuviarts (4 commits)")[![dallegoet](https://avatars.githubusercontent.com/u/1019982?v=4)](https://github.com/dallegoet "dallegoet (1 commits)")[![nchaulet](https://avatars.githubusercontent.com/u/1336873?v=4)](https://github.com/nchaulet "nchaulet (1 commits)")

### Embed Badge

![Health badge](/badges/mapado-php-sdk/health.svg)

```
[![Health](https://phpackages.com/badges/mapado-php-sdk/health.svg)](https://phpackages.com/packages/mapado-php-sdk)
```

PHPackages © 2026

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