PHPackages                             swisnl/melvin - 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. swisnl/melvin

ActiveLibrary[API Development](/categories/api)

swisnl/melvin
=============

NDW Melvin API client

2.1.1(5mo ago)26.1k↓75%1MITPHPPHP ^8.1CI failing

Since Dec 16Pushed 3mo ago1 watchersCompare

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

READMEChangelog (10)Dependencies (10)Versions (28)Used By (0)

NDW Melvin API client
=====================

[](#ndw-melvin-api-client)

[![Latest Version on Packagist](https://camo.githubusercontent.com/005e6e11535f9c30952b55c903f1efd95a836a6e8b994f40d9bdaec1c9083a2b/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f737769736e6c2f6d656c76696e2e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/swisnl/melvin)[![Software License](https://camo.githubusercontent.com/55c0218c8f8009f06ad4ddae837ddd05301481fcf0dff8e0ed9dadda8780713e/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d627269676874677265656e2e7376673f7374796c653d666c61742d737175617265)](LICENSE.md)[![Buy us a tree](https://camo.githubusercontent.com/cec0a9b35a1c3235bdbe0d13ea8fbd866a23e30280ad6ca27078c1fd4ac1b709/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f54726565776172652d2546302539462538432542332d6c69676874677265656e2e7376673f7374796c653d666c61742d737175617265)](https://plant.treeware.earth/swisnl/melvin)[![Build Status](https://camo.githubusercontent.com/ebef7e21c2228a74e38ea238788db8e9ac4efc30adaaa542ee523ab2a5060847/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f737769736e6c2f6d656c76696e2f74657374732e796d6c3f6c6162656c3d7465737473266272616e63683d6d6173746572267374796c653d666c61742d737175617265)](https://github.com/swisnl/melvin/actions/workflows/tests.yml)[![Integration Tests Status](https://camo.githubusercontent.com/f240c74dd40a550c0e61c72177e3cce3db525a93612f7e405f6f84589fa4361f/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f737769736e6c2f6d656c76696e2f696e746567726174696f6e2d74657374732e796d6c3f6c6162656c3d696e746567726174696f6e2532307465737473266272616e63683d6d6173746572267374796c653d666c61742d737175617265)](https://github.com/swisnl/melvin/actions/workflows/integration-tests.yml)[![Coverage Status](https://camo.githubusercontent.com/dae489e8b1c6700b2c32b8d8365a361362809c176ca448de33613e2f26203a83/68747470733a2f2f696d672e736869656c64732e696f2f7363727574696e697a65722f636f7665726167652f672f737769736e6c2f6d656c76696e2e7376673f7374796c653d666c61742d737175617265)](https://scrutinizer-ci.com/g/swisnl/melvin/code-structure)[![Quality Score](https://camo.githubusercontent.com/6c12b3886d4d33a0f8accfa4af1058747c1012a677622a5bb664a83bb3662835/68747470733a2f2f696d672e736869656c64732e696f2f7363727574696e697a65722f672f737769736e6c2f6d656c76696e2e7376673f7374796c653d666c61742d737175617265)](https://scrutinizer-ci.com/g/swisnl/melvin)[![Total Downloads](https://camo.githubusercontent.com/10199817ab9103d38d7526f4ff84cbf1e0e0817d24c640a7d74d7b62dac72bbf/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f737769736e6c2f6d656c76696e2e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/swisnl/melvin)[![Made by SWIS](https://camo.githubusercontent.com/ef6bdd6ab8d4f47bceb74dcf558b0915c6b419cbba320096324af0518e43091d/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f2546302539462539412538302d6d6164652532306279253230535749532d2532333037333741392e7376673f7374796c653d666c61742d737175617265)](https://www.swis.nl)

This is a (slightly opinionated) client for the [Melvin](https://melvin.ndw.nu) API by NDW. Please note that the Melvin API requires authentication, and we can't provide you with credentials.

Install
-------

[](#install)

Via Composer

```
composer require swisnl/melvin
```

N.B. Make sure you have installed a PSR-18 HTTP Client and PSR-17 HTTP Factories before you install this package or install one at the same time e.g. `composer require swisnl/json-api-client guzzlehttp/guzzle:^7.3`.

### HTTP Client

[](#http-client)

We are decoupled from any HTTP messaging client with the help of [PSR-18 HTTP Client](https://www.php-fig.org/psr/psr-18/) and [PSR-17 HTTP Factories](https://www.php-fig.org/psr/psr-17/). This requires an extra package providing [psr/http-client-implementation](https://packagist.org/providers/psr/http-client-implementation) and [psr/http-factory-implementation](https://packagist.org/providers/psr/http-factory-implementation). To use Guzzle 7, for example, simply require `guzzlehttp/guzzle`:

```
composer require guzzlehttp/guzzle:^7.3
```

Usage
-----

[](#usage)

```
use Swis\Melvin\Client;
use Swis\Melvin\SituationFilterParameters;

$client = Client::create('username', 'password');
$params = (new SituationFilterParameters())->setAreaIds([409]);

$situations = $client->situations()->export($params);

foreach ($situations as $situation) {
  // Do stuff with the situation
}
```

Change log
----------

[](#change-log)

Please see [CHANGELOG](CHANGELOG.md) for more information on what has changed recently.

Testing
-------

[](#testing)

```
composer test
```

Contributing
------------

[](#contributing)

Please see [CONTRIBUTING](CONTRIBUTING.md) and [CODE\_OF\_CONDUCT](CODE_OF_CONDUCT.md) for details.

Security
--------

[](#security)

If you discover any security related issues, please email  instead of using the issue tracker.

Credits
-------

[](#credits)

- [Jasper Zonneveld](https://github.com/swisnl)
- [All Contributors](../../contributors)

License
-------

[](#license)

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

This package is [Treeware](https://treeware.earth). If you use it in production, then we ask that you [**buy the world a tree**](https://plant.treeware.earth/swisnl/melvin) to thank us for our work. By contributing to the Treeware forest you’ll be creating employment for local families and restoring wildlife habitats.

SWIS ❤️ Open Source
-------------------

[](#swis-heart-open-source)

[SWIS](https://www.swis.nl) is a web agency from Leiden, the Netherlands. We love working with open source software.

###  Health Score

49

—

FairBetter than 95% of packages

Maintenance75

Regular maintenance activity

Popularity26

Limited adoption so far

Community13

Small or concentrated contributor base

Maturity69

Established project with proven stability

 Bus Factor1

Top contributor holds 87.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 ~57 days

Recently: every ~36 days

Total

26

Last Release

174d ago

Major Versions

1.5.5 → 2.0.02025-03-11

PHP version history (3 changes)1.0.0PHP &gt;=7.4

1.4.0PHP ^8.0

1.5.0PHP ^8.1

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/8734305?v=4)[SWIS](/maintainers/swisnl)[@swisnl](https://github.com/swisnl)

---

Top Contributors

[![JaZo](https://avatars.githubusercontent.com/u/3475007?v=4)](https://github.com/JaZo "JaZo (147 commits)")[![pjotrvdh](https://avatars.githubusercontent.com/u/2292196?v=4)](https://github.com/pjotrvdh "pjotrvdh (12 commits)")[![laravel-shift](https://avatars.githubusercontent.com/u/15991828?v=4)](https://github.com/laravel-shift "laravel-shift (5 commits)")[![Rocksheep](https://avatars.githubusercontent.com/u/1311371?v=4)](https://github.com/Rocksheep "Rocksheep (2 commits)")[![Zandv320](https://avatars.githubusercontent.com/u/75445559?v=4)](https://github.com/Zandv320 "Zandv320 (2 commits)")

---

Tags

hacktoberfestapiswisnlndwmelvin

###  Code Quality

TestsPHPUnit

Code StylePHP CS Fixer

### Embed Badge

![Health badge](/badges/swisnl-melvin/health.svg)

```
[![Health](https://phpackages.com/badges/swisnl-melvin/health.svg)](https://phpackages.com/packages/swisnl-melvin)
```

###  Alternatives

[openai-php/client

OpenAI PHP is a supercharged PHP API client that allows you to interact with the Open AI API

5.8k22.6M232](/packages/openai-php-client)[deeplcom/deepl-php

Official DeepL API Client Library

2616.2M66](/packages/deeplcom-deepl-php)[getbrevo/brevo-php

Official Brevo provided RESTFul API V3 php library

963.1M35](/packages/getbrevo-brevo-php)[jolicode/slack-php-api

An up to date PHP client for Slack's API

2534.4M12](/packages/jolicode-slack-php-api)[telnyx/telnyx-php

Official Telnyx PHP SDK — APIs for Voice, SMS, MMS, WhatsApp, Fax, SIP Trunking, Wireless IoT, Call Control, and more. Build global communications on Telnyx's private carrier-grade network.

35636.1k2](/packages/telnyx-telnyx-php)[mozex/anthropic-php

Anthropic PHP is a supercharged community-maintained PHP API client that allows you to interact with Anthropic API.

46365.1k13](/packages/mozex-anthropic-php)

PHPackages © 2026

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