PHPackages                             picqer/sendcloud-php-client - 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. picqer/sendcloud-php-client

ActiveLibrary[API Development](/categories/api)

picqer/sendcloud-php-client
===========================

A PHP Client for the SendCloud API

v2.11.1(4mo ago)45400.4k↑20.9%45[2 PRs](https://github.com/picqer/sendcloud-php-client/pulls)1MITPHPPHP &gt;=7.4.0

Since Oct 25Pushed 4mo ago7 watchersCompare

[ Source](https://github.com/picqer/sendcloud-php-client)[ Packagist](https://packagist.org/packages/picqer/sendcloud-php-client)[ Docs](https://github.com/picqer/sendcloud-php-client)[ RSS](/packages/picqer-sendcloud-php-client/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (10)Dependencies (1)Versions (44)Used By (1)

Sendcloud PHP API Client
========================

[](#sendcloud-php-api-client)

An unofficial client for the Sendcloud API. More info about Sendcloud on  Below are some examples on the usage of this client.

Full docs of the Sendcloud API can be found on [https://docs.sendcloud.sc/api/v2/index.html](https://api.sendcloud.dev/docs/sendcloud-public-api/getting-started)

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

[](#installation)

This project can easily be installed through Composer.

```
composer require picqer/sendcloud-php-client

```

Set-up connection
-----------------

[](#set-up-connection)

Prepare the client for connecting to Sendcloud with your API key and API secret. (Optionally you can send your Partner id as 3rd param.)

```
$connection = new \Picqer\Carriers\SendCloud\Connection('apikey', 'apisecret');
$sendcloudClient = new \Picqer\Carriers\SendCloud\SendCloud($connection);
```

Get all parcels
---------------

[](#get-all-parcels)

Returns an array of Parcel objects

```
$parcels = $sendcloudClient->parcels()->all();
```

Get a single parcel
-------------------

[](#get-a-single-parcel)

Returns a Parcel object

```
$parcel = $sendcloudClient->parcels()->find(2342);
```

Create a new parcel
-------------------

[](#create-a-new-parcel)

```
$parcel = $sendcloudClient->parcels();

$parcel->shipment = 10; // Shipping method, get possibilities from $sendCloud->shippingMethods()->all()

$parcel->name = 'John Smith';
$parcel->company_name = 'ACME';
$parcel->address = 'Wellingtonstreet 25';
$parcel->city = 'Wellington';
$parcel->postal_code = '3423 DD';
$parcel->country = 'NL';
$parcel->order_number = 'ORDER2014-52321';

$parcel->requestShipment = true; // Specifically needed to create a shipment after adding the parcel

$parcel->save();
```

Getting label from parcel
-------------------------

[](#getting-label-from-parcel)

```
$labelUrl = $parcel->getPrimaryLabelUrl();

$documentDownloader = new \Picqer\Carriers\SendCloud\DocumentDownloader($connection);
$labelContents = $documentDownloader->getDocument($labelUrl, 'pdf');
```

Exceptions
----------

[](#exceptions)

Actions to the API may cause an Exception to be thrown in case something went wrong

```
try {
    $parcel->save();
} catch (SendCloudApiException $e) {
    throw new Exception($e->getMessage());
}
```

Create an international parcel
------------------------------

[](#create-an-international-parcel)

```
$parcel = $sendcloudClient->parcels();

$parcel->shipment = 9; // Shipping method, get possibilities from $sendCloud->shippingMethods()->all()

$parcel->name = 'John Smith';
$parcel->company_name = 'ACME';
$parcel->address = 'Wellingtonstreet 25';
$parcel->city = 'Wellington';
$parcel->postal_code = '3423 DD';
$parcel->country = 'CH';
$parcel->order_number = 'ORDER2014-52321';
$parcel->weight = 20.4;

// For international shipments
$parcel->customs_invoice_nr = 'ORD9923882';
$parcel->customs_shipment_type = 2; // Commercial goods
$parcel->parcel_items = [
    [
        'description' => 'Cork',
        'quantity' => 2,
        'weight' => 10.2,
        'value' => 12.93,
        'hs_code' => '992783',
        'origin_country' => 'CN',
    ]
];

$parcel->requestShipment = true; // Specifically needed to create a shipment after adding the parcel

$parcel->save();
```

###  Health Score

61

—

FairBetter than 99% of packages

Maintenance76

Regular maintenance activity

Popularity50

Moderate usage in the ecosystem

Community31

Small or concentrated contributor base

Maturity76

Established project with proven stability

 Bus Factor2

2 contributors hold 50%+ of commits

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 ~105 days

Recently: every ~137 days

Total

40

Last Release

130d ago

Major Versions

v1.1.0 → v2.0.02015-06-18

PHP version history (5 changes)v1.0.0PHP &gt;=5.4.0

v2.0.0PHP &gt;=5.5.0

v2.3.0PHP &gt;=5.6.0

v2.5.0PHP &gt;=7.2.0

v2.8.1PHP &gt;=7.4.0

### Community

Maintainers

![](https://www.gravatar.com/avatar/7e81564faf640cc39dc0a13fd619ee761e6e99e7bae96ca258fcd2e7d9f8cbd5?d=identicon)[cbakker](/maintainers/cbakker)

![](https://www.gravatar.com/avatar/94084d27fbed98367df4f02d8ed51a1c9de50efc243d3d05ec0451a1f0f97860?d=identicon)[stephangroen](/maintainers/stephangroen)

---

Top Contributors

[![casperbakker](https://avatars.githubusercontent.com/u/886975?v=4)](https://github.com/casperbakker "casperbakker (44 commits)")[![stephangroen](https://avatars.githubusercontent.com/u/1607643?v=4)](https://github.com/stephangroen "stephangroen (23 commits)")[![jschram](https://avatars.githubusercontent.com/u/10851379?v=4)](https://github.com/jschram "jschram (9 commits)")[![annajeanine](https://avatars.githubusercontent.com/u/17251777?v=4)](https://github.com/annajeanine "annajeanine (8 commits)")[![kleiram](https://avatars.githubusercontent.com/u/323498?v=4)](https://github.com/kleiram "kleiram (8 commits)")[![frankverhoeven](https://avatars.githubusercontent.com/u/2358864?v=4)](https://github.com/frankverhoeven "frankverhoeven (3 commits)")[![lorro](https://avatars.githubusercontent.com/u/977617?v=4)](https://github.com/lorro "lorro (3 commits)")[![annajeanineee](https://avatars.githubusercontent.com/u/218073740?v=4)](https://github.com/annajeanineee "annajeanineee (2 commits)")[![keesschepers](https://avatars.githubusercontent.com/u/915930?v=4)](https://github.com/keesschepers "keesschepers (2 commits)")[![it-can](https://avatars.githubusercontent.com/u/644288?v=4)](https://github.com/it-can "it-can (1 commits)")[![axlon](https://avatars.githubusercontent.com/u/3661474?v=4)](https://github.com/axlon "axlon (1 commits)")[![talha-core](https://avatars.githubusercontent.com/u/124266517?v=4)](https://github.com/talha-core "talha-core (1 commits)")[![obrunsmann](https://avatars.githubusercontent.com/u/763812?v=4)](https://github.com/obrunsmann "obrunsmann (1 commits)")[![riccardopiras87](https://avatars.githubusercontent.com/u/7431204?v=4)](https://github.com/riccardopiras87 "riccardopiras87 (1 commits)")[![robbinbenard](https://avatars.githubusercontent.com/u/7994939?v=4)](https://github.com/robbinbenard "robbinbenard (1 commits)")[![rubentebogt](https://avatars.githubusercontent.com/u/8817394?v=4)](https://github.com/rubentebogt "rubentebogt (1 commits)")[![samdejongobc](https://avatars.githubusercontent.com/u/119948735?v=4)](https://github.com/samdejongobc "samdejongobc (1 commits)")[![smetje](https://avatars.githubusercontent.com/u/17066448?v=4)](https://github.com/smetje "smetje (1 commits)")[![cwdt](https://avatars.githubusercontent.com/u/9107601?v=4)](https://github.com/cwdt "cwdt (1 commits)")[![beschoenen](https://avatars.githubusercontent.com/u/1887585?v=4)](https://github.com/beschoenen "beschoenen (1 commits)")

---

Tags

parcelphpphp-clientsendcloudsendcloud-apiphpapiclientshipmentssendcloudparcels

### Embed Badge

![Health badge](/badges/picqer-sendcloud-php-client/health.svg)

```
[![Health](https://phpackages.com/badges/picqer-sendcloud-php-client/health.svg)](https://phpackages.com/packages/picqer-sendcloud-php-client)
```

###  Alternatives

[openai-php/laravel

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

3.7k7.6M74](/packages/openai-php-laravel)[kunalvarma05/dropbox-php-sdk

Dropbox PHP API V2 SDK (Unofficial)

3633.0M18](/packages/kunalvarma05-dropbox-php-sdk)[resend/resend-php

Resend PHP library.

574.7M21](/packages/resend-resend-php)[mozex/anthropic-laravel

Anthropic PHP for Laravel is a supercharged PHP API client that allows you to interact with the Anthropic API

71226.4k1](/packages/mozex-anthropic-laravel)[jouwweb/sendcloud

Provides a client to interact with the Sendcloud API in an object-oriented way.

16256.9k1](/packages/jouwweb-sendcloud)[sima-land/api-php-client

Client library for Simaland APIs

311.5k](/packages/sima-land-api-php-client)

PHPackages © 2026

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