PHPackages                             mbs-hub/moco-php - 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. mbs-hub/moco-php

ActiveLibrary[API Development](/categories/api)

mbs-hub/moco-php
================

PHP SDK for the MOCO API

2.0.0(9mo ago)288MITPHPPHP ^8.2CI passing

Since Aug 17Pushed 9mo agoCompare

[ Source](https://github.com/mbs-hub/moco-php)[ Packagist](https://packagist.org/packages/mbs-hub/moco-php)[ RSS](/packages/mbs-hub-moco-php/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (2)Dependencies (15)Versions (3)Used By (0)

MOCO PHP SDK
============

[](#moco-php-sdk)

[![Latest Version on Packagist](https://camo.githubusercontent.com/397829f9e42987d3a5fb234af59be0af4669a46fcb4247f13560d25946ac7bac/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6d62732d6875622f6d6f636f2d7068702e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/mbs-hub/moco-php)[![Build Status](https://github.com/mbs-hub/moco-php/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/mbs-hub/moco-php/actions?query=branch%3Amain)

The **MOCO PHP SDK** provides convenient access to the [MOCO API](https://everii-group.github.io/mocoapp-api-docs/) from applications written in PHP. It includes a comprehensive set of pre-built services and models to simplify integration with MOCO's time tracking, project management, and invoicing platform.

✨ Features
----------

[](#-features)

- **🏗️ Service-Oriented Architecture**: Clean, organized service classes for each API endpoint
- **📋 Comprehensive Entity System**: Strongly typed models for all MOCO resources
- **🔧 PSR Standards Compliant**: Built on PSR-7 (HTTP Message), PSR-17 (HTTP Factories), and PSR-18 (HTTP Client)
- **⚡ Automatic Parameter Validation**: Built-in validation for required fields
- **🔌 Flexible HTTP Client**: Works with any PSR-18 compatible HTTP client
- **🎯 Full MOCO API Coverage**: Support for all major MOCO features including users, projects, activities, invoices, and more

🐛 Bug Reports
-------------

[](#-bug-reports)

Found a bug? We'd love to hear about it! Please help us improve the MOCO PHP SDK by reporting any issues you encounter.

**🔗 Report a Bug**: [Create an issue on GitHub](https://github.com/mbs-hub/moco-php/issues)

When reporting a bug, please include:

- 📝 Clear description of the issue
- 🔄 Steps to reproduce the problem
- 🎯 Expected vs actual behavior
- 🛠️ PHP version and SDK version
- 📋 Any relevant code snippets or error messages

Your feedback helps make this library better for everyone! 🚀

📑 Table of Contents
-------------------

[](#-table-of-contents)

- [Requirements](#-requirements)
- [Installation](#-installation)
- [Quick Start](#-quick-start)
- [Authentication](#-authentication)
- [Usage Examples](#-usage-examples)
    - [Users Management](#users-management)
    - [Companies & Contacts](#companies--contacts)
    - [Projects & Tasks](#projects--tasks)
    - [Activities & Time Tracking](#activities--time-tracking)
    - [Invoices & Payments](#invoices--payments)
    - [Offers & Deals](#offers--deals)
- [API Reference](#-api-reference)
- [Contributing](#-contributing)
- [Versioning](#-versioning)
- [License](#-license)

🔧 Requirements
--------------

[](#-requirements)

- **PHP 8.2** or higher
- **Required Extensions**: `curl`, `json`, `mbstring`
- **Composer** for dependency management
- A valid [MOCO account](https://www.mocoapp.com/) and API token

### Dependencies

[](#dependencies)

This library uses the following PSR-compatible packages:

- `psr/http-message` - HTTP message interfaces (PSR-7)
- `psr/http-client-implementation` - HTTP client implementation (PSR-18)
- `php-http/httplug` - HTTP client abstraction
- `php-http/discovery` - Automatic HTTP client discovery
- `symfony/http-client` - Default HTTP client implementation

📦 Installation
--------------

[](#-installation)

### Via Composer (Recommended)

[](#via-composer-recommended)

Install the latest version with [Composer](https://getcomposer.org/):

```
composer require mbs-hub/moco-php
```

🚀 Quick Start
-------------

[](#-quick-start)

Get up and running with the MOCO API in minutes:

```