PHPackages                             cbeyersdorf/easybill - 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. [HTTP & Networking](/categories/http)
4. /
5. cbeyersdorf/easybill

ActiveLibrary[HTTP & Networking](/categories/http)

cbeyersdorf/easybill
====================

The first version of the easybill REST API. \[CHANGELOG\](https://api.easybill.de/rest/v1/CHANGELOG.md) ## Authentication You can choose between two available methods: `Basic Auth` or `Bearer Token`. In each HTTP request, one of the following HTTP headers is required: ``` # Basic Auth Authorization: Basic base64\_encode('<email>:<api\_key>') # Bearer Token Authorization: Bearer <api\_key> ``` ## Limitations ### Request Limit \* PLUS: 10 requests per minute \* BUSINESS: 60 requests per minute If the limit is exceeded, you will receive the HTTP error: `429 Too Many Requests` ### Result Limit All result lists are limited to 100 by default. This limit can be increased by the query parameter `limit` to a maximum of 1000. ## Query filter Many list resources can be filtered. In `/documents` you can filter e.g. by number with `/documents?number=111028654`. If you want to filter multiple numbers, you can either enter them separated by commas `/documents?number=111028654,222006895` or as an array `/documents?number\[\]=111028654&number\[\]=222006895`. \*\*Warning\*\*: The maximum size of an HTTP request line in bytes is 4094. If this limit is exceeded, you will receive the HTTP error: `414 Request-URI Too Large` ### Escape commas in query You can escape commans in query `name=Patrick\\, Peter` if you submit the header `X-Easybill-Escape: true` in your request. ## Property login\_id This is the login of your admin or employee account. ## Date and Date-Time format Please use the timezone `Europe/Berlin`. \* \*\*date\*\* = \*Y-m-d\* = `2016-12-31` \* \*\*date-time\*\* = \*Y-m-d H:i:s\* = `2016-12-31 03:13:37` Date or datetime can be `null` because the attributes have been added later and the entry is older.

v1.94.0(2mo ago)32unlicensePHPPHP ^8.1CI passing

Since Jan 19Pushed 2mo ago3 watchersCompare

[ Source](https://github.com/cbeyersdorf/easybill)[ Packagist](https://packagist.org/packages/cbeyersdorf/easybill)[ Docs](https://openapi-generator.tech)[ RSS](/packages/cbeyersdorf-easybill/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (3)Dependencies (8)Versions (19)Used By (0)

easybill
========

[](#easybill)

The first version of the easybill REST API. [CHANGELOG](https://api.easybill.de/rest/v1/CHANGELOG.md)

Authentication
--------------

[](#authentication)

You can choose between two available methods: `Basic Auth` or `Bearer Token`.

In each HTTP request, one of the following HTTP headers is required:

```
# Basic Auth
Authorization: Basic base64_encode(':')
# Bearer Token
Authorization: Bearer

```

Limitations
-----------

[](#limitations)

### Request Limit

[](#request-limit)

- PLUS: 10 requests per minute
- BUSINESS: 60 requests per minute

If the limit is exceeded, you will receive the HTTP error: `429 Too Many Requests`

### Result Limit

[](#result-limit)

All result lists are limited to 100 by default. This limit can be increased by the query parameter `limit` to a maximum of 1000.

Query filter
------------

[](#query-filter)

Many list resources can be filtered. In `/documents` you can filter e.g. by number with `/documents?number=111028654`. If you want to filter multiple numbers, you can either enter them separated by commas `/documents?number=111028654,222006895` or as an array `/documents?number[]=111028654&number[]=222006895`.

**Warning**: The maximum size of an HTTP request line in bytes is 4094. If this limit is exceeded, you will receive the HTTP error: `414 Request-URI Too Large`

### Escape commas in query

[](#escape-commas-in-query)

You can escape commans in query `name=Patrick\\, Peter` if you submit the header `X-Easybill-Escape: true` in your request.

Property login\_id
------------------

[](#property-login_id)

This is the login of your admin or employee account.

Date and Date-Time format
-------------------------

[](#date-and-date-time-format)

Please use the timezone `Europe/Berlin`.

- **date** = *Y-m-d* = `2016-12-31`
- **date-time** = *Y-m-d H:i:s* = `2016-12-31 03:13:37`

Date or datetime can be `null` because the attributes have been added later and the entry is older.

Installation & Usage
------------------------

[](#installation--usage)

### Requirements

[](#requirements)

PHP 8.1 and later.

### Composer

[](#composer)

To install the bindings via [Composer](https://getcomposer.org/), add the following to `composer.json`:

```
{
  "repositories": [
    {
      "type": "vcs",
      "url": "https://github.com/cbeyersdorf/easybill.git"
    }
  ],
  "require": {
    "cbeyersdorf/easybill": "*@dev"
  }
}
```

Then run `composer install`

### Manual Installation

[](#manual-installation)

Download the files and include `autoload.php`:

```