PHPackages                             homedoctor-es/holded-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. [API Development](/categories/api)
4. /
5. homedoctor-es/holded-php-sdk

ActiveLibrary[API Development](/categories/api)

homedoctor-es/holded-php-sdk
============================

A PHP package to access the Holded API by a comprehensive way.

1.0.3(4y ago)04.3k↓35%21BSD-3-ClausePHPPHP >=7.0

Since Nov 17Pushed 1y ago1 watchersCompare

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

READMEChangelog (5)Dependencies (3)Versions (5)Used By (1)

Holded PHP SDK
==============

[](#holded-php-sdk)

A PHP package to access the Holded API by a comprehensive way

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

[](#installation)

The preferred way to install this extension is through [composer](http://getcomposer.org/download/).

With Composer installed, you can then install the extension using the following commands:

```
$ php composer.phar require homedoctor-es/holded-php-sdk
```

or add

```
...
    "require": {
        "homedoctor-es/holded-php-sdk": "*"
    }
```

to the `require` section of your `composer.json` file.

Configuration
-------------

[](#configuration)

You can set the HOLDED\_API\_TOKEN as environment variables or add them later on Holded class instantiation.

The name of the environment var is HOLDED\_API\_KEY.

Usage
-----

[](#usage)

Endpoints calls must done through the Holded class.

If you haven't set the environment variable previously, remember to provide the key on instantiation.

```
$holded = new \HomedoctorEs\Holded\Holded($holdedApiKey); // or Holded::make($holdedApiKey)
$holded->contact()->list();
```

Endpoints
---------

[](#endpoints)

At this moment, only can be managed 2 entities with this SDK: contacts and documents

### Contacts

[](#contacts)

To check contacts entity requirements and fields, you can see

The contacts entity use these methods

```
$holded->contact()->list();
$holded->contact()->get($id);
$holded->contact()->create($data); //$data = []
$holded->contact()->update($data); //$data = []
$holded->contact()->delete($id);
```

### Documents

[](#documents)

To check documents entity requirements and fields, you can see

The contacts entity use these methods

```
$holded->document()->list();
$holded->document()->get($id);
$holded->document()->create($data); //$data = []
$holded->document()->update($data); //$data = []
$holded->document()->delete($id); //$data = []
```

"docType" default value is invoice, if you want to instantiate another kind of document, you can pass docType param to document method

```
$document = $holded->document(Document::PURCHASE_ORDER);
```

Check Document class constants to see the kind of docType you can use

If you want to instantiate directly and invoice document you can do it using ->invoice() method

```
$invoice = $holded->invoice();
```

###  Health Score

30

—

LowBetter than 64% of packages

Maintenance26

Infrequent updates — may be unmaintained

Popularity24

Limited adoption so far

Community13

Small or concentrated contributor base

Maturity48

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 75% 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 ~22 days

Total

4

Last Release

1574d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/13337359?v=4)[Homedoctor](/maintainers/Homedoctor)[@HomeDoctor](https://github.com/HomeDoctor)

---

Top Contributors

[![jsolam](https://avatars.githubusercontent.com/u/34037044?v=4)](https://github.com/jsolam "jsolam (3 commits)")[![jaumebosch](https://avatars.githubusercontent.com/u/5648387?v=4)](https://github.com/jaumebosch "jaumebosch (1 commits)")

---

Tags

phpholdedhomedoctor-es

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/homedoctor-es-holded-php-sdk/health.svg)

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

###  Alternatives

[theodo-group/llphant

LLPhant is a library to help you build Generative AI applications.

1.5k311.5k5](/packages/theodo-group-llphant)[mailchimp/transactional

458.9M16](/packages/mailchimp-transactional)[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)[scriptdevelop/whatsapp-manager

Paquete para manejo de WhatsApp Business API en Laravel

762.6k](/packages/scriptdevelop-whatsapp-manager)[sandorian/moneybird-api-php

Moneybird API client for PHP

127.3k](/packages/sandorian-moneybird-api-php)

PHPackages © 2026

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