PHPackages                             jolicode/harvest-php-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. jolicode/harvest-php-api

ActiveLibrary[API Development](/categories/api)

jolicode/harvest-php-api
========================

An up to date PHP client for Harvest's API

v8.1.0(6mo ago)2259.9k—8.9%6[1 issues](https://github.com/jolicode/harvest-php-api/issues)MITPHPPHP >=8.2CI passing

Since Jan 21Pushed 6mo ago12 watchersCompare

[ Source](https://github.com/jolicode/harvest-php-api)[ Packagist](https://packagist.org/packages/jolicode/harvest-php-api)[ RSS](/packages/jolicode-harvest-php-api/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (10)Dependencies (7)Versions (29)Used By (0)

A PHP Client for Harvest API
============================

[](#a-php-client-for-harvest-api)

[![example workflow](https://github.com/jolicode/harvest-php-api/actions/workflows/tests.yml/badge.svg)](https://github.com/jolicode/harvest-php-api/actions/workflows/tests.yml/badge.svg)

[Harvest](https://www.getharvest.com/) is a time tracking and invoicing tool.

This PHP SDK is generated automatically with [JanePHP](https://github.com/janephp/janephp) using a [Harvest OpenAPI specification](https://github.com/jolicode/harvest-openapi-generator/) generated from the HTML documentation. It means that:

- all the API endpoints and parameters are supported. See the [list of available endpoints](doc/index.md#available-operations);
- when the documentation changes, it is easy to update the library and keep up-to-date.

The API is tested against the examples provided by the Harvest API documentation.

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

[](#installation)

This library is built atop of [PSR-7](https://www.php-fig.org/psr/psr-7/) and [PSR-18](https://www.php-fig.org/psr/psr-18/). So you will need to install some implementations for those interfaces.

If no PSR-18 client or PSR-7 message factory is available yet in your project or you don't know or don't care which one to use, just install some default:

```
composer require symfony/http-client nyholm/psr7
```

You can now install the Harvest client:

```
composer require jolicode/harvest-php-api
```

Usage
-----

[](#usage)

First, you need to retrieve an access token. Please checkout Harvest's documentation about the [OAuth2 Authorization Flow](https://help.getharvest.com/api-v2/authentication-api/authentication/authentication/#for-server-side-applications).

Then, use the factory that is provided to create the client:

```
// $harvestClient contains all the methods to interact with the API
$harvestClient = JoliCode\Harvest\ClientFactory::create(
  $accessToken,
  $harvestAccountId
);

$clients = $harvestClient->listClients([
  'is_active' => true,
])->getClients();

dump($clients);
```

Want more example or documentation? See the [documentation](doc/index.md), which lists all the available methods.

Troubleshoot
------------

[](#troubleshoot)

Got some problems using this library? Need a missing feature? Do not hesitate to [open an issue](https://github.com/jolicode/harvest-php-api/issues)and share it with us.

Further documentation
---------------------

[](#further-documentation)

You can see the current and past versions using one of the following:

- the `git tag` command
- the [releases page on Github](https://github.com/jolicode/harvest-php-api/releases)
- the file listing the [changes between versions](CHANGELOG.md)

And finally some meta documentation:

- [versioning and branching models](VERSIONING.md)
- [contribution instructions](CONTRIBUTING.md)

License
-------

[](#license)

This library is licensed under the MIT License - see the [LICENSE](LICENSE.md)file for details.

###  Health Score

56

—

FairBetter than 98% of packages

Maintenance65

Regular maintenance activity

Popularity41

Moderate usage in the ecosystem

Community17

Small or concentrated contributor base

Maturity84

Battle-tested with a long release history

 Bus Factor1

Top contributor holds 96.3% 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 ~91 days

Recently: every ~202 days

Total

28

Last Release

196d ago

Major Versions

v3.0.3 → v4.0.02020-05-14

v4.3.0 → v5.0.02021-04-10

v5.2.0 → v6.0.02022-08-04

v6.3.0 → v7.0.02024-03-29

v7.1.0 → v8.0.02025-03-27

PHP version history (6 changes)v1.0.0PHP >= 7.1

v5.0.0PHP ^7.2 || ^8.0

v6.0.0PHP >=7.4

v6.2.0PHP >=8.0

v7.0.0PHP >=8.1

v8.0.0PHP >=8.2

### Community

Maintainers

![](https://www.gravatar.com/avatar/c6547f10fb51d1e84f1d5371fb44ee3593c7791432471f0b0adabfb29a18c507?d=identicon)[xavierlacot](/maintainers/xavierlacot)

---

Top Contributors

[![xavierlacot](https://avatars.githubusercontent.com/u/177293?v=4)](https://github.com/xavierlacot "xavierlacot (104 commits)")[![jdrieghe](https://avatars.githubusercontent.com/u/12606789?v=4)](https://github.com/jdrieghe "jdrieghe (3 commits)")[![adamj88](https://avatars.githubusercontent.com/u/1053393?v=4)](https://github.com/adamj88 "adamj88 (1 commits)")

---

Tags

harvest-apijane-phpopenapiswaggerclientsdkswaggeropenapiHarvestharvestappharvest api

### Embed Badge

![Health badge](/badges/jolicode-harvest-php-api/health.svg)

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

###  Alternatives

[jolicode/slack-php-api

An up to date PHP client for Slack's API

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

Client library for connecting to the Apigee Edge API.

27558.7k3](/packages/apigee-apigee-client-php)[deepseek-php/deepseek-php-client

deepseek PHP client is a robust and community-driven PHP client library for seamless integration with the Deepseek API, offering efficient access to advanced AI and data processing capabilities.

47073.9k5](/packages/deepseek-php-deepseek-php-client)[dhope0000/lxd

PHP-based API wrapper for LXD REST API.

136.2k](/packages/dhope0000-lxd)

PHPackages © 2026

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