PHPackages                             postbode/postbode-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. postbode/postbode-api

ActiveLibrary[API Development](/categories/api)

postbode/postbode-api
=====================

Official supported client for Postbode.nu (https://postbode.nu)

2.1.2(5y ago)437.8k↓51.5%2MITPHPPHP ^7.0 | ^8.0CI failing

Since Feb 9Pushed 5y ago2 watchersCompare

[ Source](https://github.com/postbode/postbode-api)[ Packagist](https://packagist.org/packages/postbode/postbode-api)[ RSS](/packages/postbode-postbode-api/feed)WikiDiscussions master Synced yesterday

READMEChangelog (4)Dependencies (2)Versions (10)Used By (0)

Postbode.nu API
===============

[](#postbodenu-api)

Getting started
---------------

[](#getting-started)

- Register an account on Postbode.nu ()
- Create an API key ()

Initialize composer package
---------------------------

[](#initialize-composer-package)

```
composer require postbode/postbode-api
```

Complete documentation
----------------------

[](#complete-documentation)

Our complete API is available at

Usage
-----

[](#usage)

### List all available mailboxes

[](#list-all-available-mailboxes)

```
$postbode = new \Postbode\PostbodeClient(API_KEY);
$mailboxes = $postbode->getMailboxes();
foreach($mailboxes AS $mailbox){
    // use $mailbox
}
```

### List all letters in mailbox

[](#list-all-letters-in-mailbox)

```
$postbode = new \Postbode\PostbodeClient(API_KEY);
$letters = $postbode->getLetters(MAILBOX_ID);
foreach($letters AS $letter){
    // use $letter
}
```

### Send letter

[](#send-letter)

```
$postbode = new \Postbode\PostbodeClient(API_KEY);

$filename = 'example.pdf';
$envelope_id = 2;
$country = 'NL';
$registered = false; // Registered letter
$send_direct = false; // Create concept in mailbox

$letter = $postbode->sendLetter(MAILBOX_ID, $filename, $envelope_id, $country, $registered, $send_direct);
if(!is_array($letter)){
    echo 'Failed! Errorcode: '.$letter;
}else{
    echo 'Letter sent!';
    echo '';
    print_r($letter);
}
```

### Add letters to queue and send in one request

[](#add-letters-to-queue-and-send-in-one-request)

```
$postbode = new \Postbode\PostbodeClient(API_KEY);

$envelope_id = 2;
$country = 'NL';
$registered = false; // Registered letter
$send_direct = false; // Create concept in mailbox

$postbode->addLetterToQueue(MAILBOX_ID, 'Letter_A.pdf', $envelope_id, $country, $registered, $send_direct);
$postbode->addLetterToQueue(MAILBOX_ID, 'Letter_B.pdf', $envelope_id, $country, $registered, $send_direct);
$postbode->sendLetterQueue();

if(!is_array($letter)){
    echo 'Failed! Errorcode: '.$letter;
}else{
    echo 'Letter sent!';
    echo '';
    print_r($letter);
}
```

###  Health Score

38

—

LowBetter than 83% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity34

Limited adoption so far

Community13

Small or concentrated contributor base

Maturity71

Established project with proven stability

 Bus Factor1

Top contributor holds 60% 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 ~87 days

Recently: every ~157 days

Total

9

Last Release

2004d ago

Major Versions

1.0.5 → 2.0.02020-06-28

PHP version history (3 changes)1.0.0PHP >=7.0

2.1.0PHP ~7.0

2.1.2PHP ^7.0 | ^8.0

### Community

Maintainers

![](https://www.gravatar.com/avatar/67b74c6f8cf3c9512fc139dd35ffa036a923ec9d42bcde167951877ee3c7ff33?d=identicon)[markhameetman](/maintainers/markhameetman)

---

Top Contributors

[![markhameetman](https://avatars.githubusercontent.com/u/364344?v=4)](https://github.com/markhameetman "markhameetman (12 commits)")[![DanielGSoftware](https://avatars.githubusercontent.com/u/49187378?v=4)](https://github.com/DanielGSoftware "DanielGSoftware (7 commits)")[![lvdhoorn](https://avatars.githubusercontent.com/u/22305189?v=4)](https://github.com/lvdhoorn "lvdhoorn (1 commits)")

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/postbode-postbode-api/health.svg)

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

###  Alternatives

[statamic/cms

The Statamic CMS Core Package

4.8k3.6M986](/packages/statamic-cms)[tencentcloud/tencentcloud-sdk-php

TencentCloudApi php sdk

3741.3M47](/packages/tencentcloud-tencentcloud-sdk-php)[neuron-core/neuron-ai

The PHP Agentic Framework.

2.0k656.1k38](/packages/neuron-core-neuron-ai)[avalara/avataxclient

Client library for Avalara's AvaTax suite of business tax calculation and processing services. Uses the REST v2 API.

528.5M7](/packages/avalara-avataxclient)[eslazarev/wildberries-sdk

Wildberries OpenAPI clients (generated).

273.0k](/packages/eslazarev-wildberries-sdk)[files.com/files-php-sdk

Files.com PHP SDK

2481.1k](/packages/filescom-files-php-sdk)

PHPackages © 2026

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