PHPackages                             debuss-a/lapostesuivi - 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. debuss-a/lapostesuivi

ActiveLibrary[API Development](/categories/api)

debuss-a/lapostesuivi
=====================

This API allows you to track your La Poste shipments in real time.

2.2.10(1y ago)21.9k1MITPHPCI failing

Since Feb 20Pushed 1y ago1 watchersCompare

[ Source](https://github.com/debuss/lapostesuivi)[ Packagist](https://packagist.org/packages/debuss-a/lapostesuivi)[ RSS](/packages/debuss-a-lapostesuivi/feed)WikiDiscussions master Synced 1w ago

READMEChangelog (10)Dependencies (1)Versions (15)Used By (0)

[![Logo](https://camo.githubusercontent.com/fc0b4f2466186c3c8e468f7ddbd865e223668aca3b3f381036d24bba0a222a9b/68747470733a2f2f7777772e64726f70626f782e636f6d2f732f773537316b7a64616a7932796461732f6c61706f73746573756976692e6a70673f7261773d31)](https://camo.githubusercontent.com/fc0b4f2466186c3c8e468f7ddbd865e223668aca3b3f381036d24bba0a222a9b/68747470733a2f2f7777772e64726f70626f782e636f6d2f732f773537316b7a64616a7932796461732f6c61706f73746573756976692e6a70673f7261773d31)

La Poste Suivi API
==================

[](#la-poste-suivi-api)

The best way to track your La Poste, Colissimo and Chronopost packages.

[![Travis](https://camo.githubusercontent.com/a62b29aec4a3622f4d53f79d1fec79df7b05a7da362b193b656aa34775ddb7d9/68747470733a2f2f7472617669732d63692e636f6d2f6465627573732f6c61706f73746573756976692e7376673f6272616e63683d6d6173746572)](//travis-ci.com/github/debuss/lapostesuivi)[![Version](https://camo.githubusercontent.com/1035da2d3fe931e0fa09d45f163dec6b096c5d21aa457f2b2d823888fc4ace7d/68747470733a2f2f706f7365722e707567782e6f72672f6465627573732d612f6c61706f73746573756976692f76)](//packagist.org/packages/debuss-a/lapostesuivi)[![License](https://camo.githubusercontent.com/0c6f0ecd48da93cf1a66c4960139855a77b4d0d83e81cfb98f68b4292bd94216/68747470733a2f2f706f7365722e707567782e6f72672f6465627573732d612f6c61706f73746573756976692f6c6963656e7365)](//packagist.org/packages/debuss-a/lapostesuivi)

[![Example](https://camo.githubusercontent.com/a12ddeaba46254906e1816814cc110b677dbf28c5418cda539a4636cfe8360ed/68747470733a2f2f7777772e64726f70626f782e636f6d2f732f36307563397871713066336d7a6c342f6c61706f73746573756976695f6578616d706c652e706e673f7261773d31)](https://camo.githubusercontent.com/a12ddeaba46254906e1816814cc110b677dbf28c5418cda539a4636cfe8360ed/68747470733a2f2f7777772e64726f70626f782e636f6d2f732f36307563397871713066336d7a6c342f6c61706f73746573756976695f6578616d706c652e706e673f7261773d31)

What does it do ?
-----------------

[](#what-does-it-do-)

This framework-agnostic package is an implementation of the tracking API version 2 from La Poste.
This API allows you to track your shipments in real time. "Suivi v2" allows you to harmonize the delivery status of tracked parcels, Colissimo parcels and Chronopost shipments.

More information on the [developer page](https://developer.laposte.fr/products/suivi/2).

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

[](#installation)

It is recommended to use [composer](https://getcomposer.org/) to install the package :

```
$ composer require debuss-a/lapostesuivi:^2

```

PHP 5.6 or newer is required.

Usage
-----

[](#usage)

First of all you need an X-Okapi-Key to use the API.
Subscribe to a new Tracking API to get one **(it is free)**, [here](https://developer.laposte.fr/products/suivi/2), then you can instantiate the app :

```
require_once __DIR__.'/vendor/autoload.php';

$app = new LaPoste\Suivi\App('YOUR_X-OKAPI-KEY_HERE');
```

You need to create an object `Request` for every tracking number :

```
$request = new \LaPoste\Suivi\Request('6M17554710224');
```

You can pass 2 more parameters to define the `lang` and `ip_address` you wish to set up. By default, `lang` is set to `fr_FR` and `ip_address` to `$_SERVER['REMOTE_ADDR']` (or `123.123.123.123` if `REMOTE_ADDR` is not defined).

To track only 1 parcel, you can use the `LaPoste\Suivi\App::call` method :

```
require_once __DIR__.'/vendor/autoload.php';

$app = new LaPoste\Suivi\App('YOUR_X-OKAPI-KEY_HERE');
$request = new \LaPoste\Suivi\Request('6M17554710224');
$response = $app->call($request);
```

To track more than 1 parcel, use the `LaPoste\Suivi\App::callMultiple` method :

```
require_once __DIR__.'/vendor/autoload.php';

$app = new LaPoste\Suivi\App('YOUR_X-OKAPI-KEY_HERE');
$requests = [
    new \LaPoste\Suivi\Request('6M17554710224'),
    new \LaPoste\Suivi\Request('EY604176344FR', LaPoste\Suivi\App::LANG_EN),
    new \LaPoste\Suivi\Request('6M17554710224'),
];
$responses = $app->callMultiple($requests);
```

`LaPoste\Suivi\App::call` and `LaPoste\Suivi\App::callMultiple` return instances of [`LaPoste\Suivi\Response`](https://github.com/debuss/lapostesuivi/blob/master/src/Suivi/Response.php).

Note: in the case of `LaPoste\Suivi\App::callMultiple`, this package uses `curl_multi*` functions therefore all tracking numbers are tracked asynchronously.
This means the tracking of multiple packages is done at the same time instead of one by one, and it is much **MUCH!** faster.

Decorator
---------

[](#decorator)

The package is included with an `AppV1Decorator` decorator class that you can use to format the output of the v2 API to the v1 API.

```
$app = new \LaPoste\Suivi\AppV1Decorator(
    new LaPoste\Suivi\App('YOUR_X-OKAPI-KEY_HERE')
);

$single_response = $app->call(new \LaPoste\Suivi\Request('6A18987970674'));

$multiple_response = $app->callMultiple([
    new \LaPoste\Suivi\Request('6A18987970674'),
    new \LaPoste\Suivi\Request('6A18987970674'),
    new \LaPoste\Suivi\Request('6A18987970674')
]);
```

Result of `call` :

```
array (
  'code' => '6A18987970674',
  'date' => '06/07/2020',
  'status' => 'LIVRE',
  'message' => 'Votre colis est livré à votre gardien.',
  'link' => 'https://www.laposte.fr/particulier/outils/suivre-vos-envois?code=6A18987970674',
  'type' => 'Colissimo',
)

```

Result of `callMultiple` :

```
array (
  0 => array (
    'data' => array (
      'code' => '6A18987970674',
      'date' => '06/07/2020',
      'status' => 'LIVRE',
      'message' => 'Votre colis est livré à votre gardien.',
      'link' => 'https://www.laposte.fr/particulier/outils/suivre-vos-envois?code=6A18987970674',
      'type' => 'Colissimo',
    ),
  ),
  1 => array (
    'data' => array (
      'code' => '6A18987970674',
      'date' => '06/07/2020',
      'status' => 'LIVRE',
      'message' => 'Votre colis est livré à votre gardien.',
      'link' => 'https://www.laposte.fr/particulier/outils/suivre-vos-envois?code=6A18987970674',
      'type' => 'Colissimo',
    ),
  ),
  2 => array (
    'data' => array (
      'code' => '6A18987970674',
      'date' => '06/07/2020',
      'status' => 'LIVRE',
      'message' => 'Votre colis est livré à votre gardien.',
      'link' => 'https://www.laposte.fr/particulier/outils/suivre-vos-envois?code=6A18987970674',
      'type' => 'Colissimo',
    ),
  ),
)

```

Useful if you do not want to refactor all your code to the different v2 API !

License
-------

[](#license)

The package is licensed under the MIT license. See [License File](https://github.com/debuss/lapostesuivi/blob/master/LICENSE.md) for more information.

###  Health Score

36

—

LowBetter than 82% of packages

Maintenance38

Infrequent updates — may be unmaintained

Popularity20

Limited adoption so far

Community10

Small or concentrated contributor base

Maturity64

Established project with proven stability

 Bus Factor1

Top contributor holds 76.2% 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 ~144 days

Recently: every ~275 days

Total

13

Last Release

542d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/0e1a70117520fe10a630d61c750bbe6888d174e9903825e741470f818ee2c5d1?d=identicon)[debuss-a](/maintainers/debuss-a)

---

Top Contributors

[![debuss](https://avatars.githubusercontent.com/u/2537607?v=4)](https://github.com/debuss "debuss (16 commits)")[![tucoinfo](https://avatars.githubusercontent.com/u/1420304?v=4)](https://github.com/tucoinfo "tucoinfo (5 commits)")

---

Tags

trackingcolissimolapostepostesuivi

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/debuss-a-lapostesuivi/health.svg)

```
[![Health](https://phpackages.com/badges/debuss-a-lapostesuivi/health.svg)](https://phpackages.com/packages/debuss-a-lapostesuivi)
```

###  Alternatives

[gabrielbull/ups-api

PHP UPS API

4642.4M10](/packages/gabrielbull-ups-api)[irazasyed/laravel-gamp

Send analytics data to Google Analytics from Laravel. A package for GA Measurement Protocol API

3361.6M1](/packages/irazasyed-laravel-gamp)[shippo/shippo-php

A PHP library for connecting with multiple carriers (FedEx, UPS, USPS) using Shippo.

1711.8M2](/packages/shippo-shippo-php)[gavroche/ups-api

PHP UPS API

45613.2k](/packages/gavroche-ups-api)[alexwestergaard/php-ga4

PHP Library for Google Analytics 4 with Server Side Tagging

63144.7k1](/packages/alexwestergaard-php-ga4)[hedii/colissimo-api

A php package to track Colissimo (La Poste) parcels

221.7k](/packages/hedii-colissimo-api)

PHPackages © 2026

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