PHPackages                             drei-d/laravel-jtl-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. drei-d/laravel-jtl-api

ActiveLibrary[API Development](/categories/api)

drei-d/laravel-jtl-api
======================

a JTL api wrapper for Laravel

1.6.0(1mo ago)0680—0%MITPHPPHP ^8.2

Since Jul 23Pushed 1mo agoCompare

[ Source](https://github.com/DREI-D/laravel-jtl-api)[ Packagist](https://packagist.org/packages/drei-d/laravel-jtl-api)[ RSS](/packages/drei-d-laravel-jtl-api/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (10)Dependencies (1)Versions (30)Used By (0)

Laravel JTL API
===============

[](#laravel-jtl-api)

This Laravel package provides a wrapper for the new JTL Wawi API.

Requirements
------------

[](#requirements)

- Laravel 11 or 12
- PHP 8.2 or higher

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

[](#installation)

You can install this package via [Composer](https://packagist.org/packages/drei-d/laravel-jtl-api).

```
composer require drei-d/laravel-jtl-api
```

Setup
-----

[](#setup)

### Preparations

[](#preparations)

First, publish the assets and config provided by this package.

```
php artisan vendor:publish --provider DREID\\LaravelJtlApi\\Providers\\ServiceProvider
```

This creates a new config file named `jtl-api.php` in your config directory, as well as an app icon image in your resources directory.

Please update the config file to your needs. It contains...

- Basic app information, such as the app name and provider
- Required permissions by your app.

As of now, permissions cannot be altered once the app is registered, please proceed with caution.

When finished, add the first two entries of the config to your `.env` file.
You can leave the api key blank for now:

```
JTL_API_BASE_URL=
JTL_API_KEY=
```

### App Registration

[](#app-registration)

After setting up your local environment, you have to register your app in the JTL Wawi.
Please start by opening the registration listener (everything until step 5) as described in the [official documentation](https://guide.jtl-software.com/jtl-wawi/jtl-wawi-api/jtl-wawi-api-nutzen/).

To register your app, you can use the `AppRegistrationHelper` provided by this package.
Use it as follows, for example in a command:

```
$tokenDto = app(\DREID\LaravelJtlApi\Helpers\AppRegistrationHelper::class)->register();
```

Once called, you can proceed to register your app (continue at step 5) as described in the [official documentation](https://guide.jtl-software.com/jtl-wawi/jtl-wawi-api/jtl-wawi-api-nutzen/). The registration helper sends a checkup request every five seconds, it may take a moment to receive the token from the JTL Wawi, when the manual registration is completed.

Afterward, a dump of the token should like something like this:

```
DREID\LaravelJtlApi\Modules\AppRegistration\DataTransferObjects\TokenDto^ {#843
  +apiKey: "0b1ee12b-2cf8-4fd5-9920-b104789621f0"
} // app/Console/Commands/RegisterAppCommand.php:31

```

Copy the api key and paste it into your `.env` file.

Usage
-----

[](#usage)

Once the registration is completed successfully, you can start using the included repositories.

For example, to list all companies, run:

```
$repository = app(\DREID\LaravelJtlApi\Modules\Company\CompanyRepository::class);
$response = $repository->queryCompanies();

dump($response->companies);
```

There are also cases, where you might want to add a request body, for example with the customer endpoint:

```
$repository = app(\DREID\LaravelJtlApi\Modules\Customer\CustomerRepository::class);

$response = $repository->queryCustomers(
    new \DREID\LaravelJtlApi\Modules\Customer\Requests\QueryCustomersRequest(
        searchKeyWord: 'Mustermann',
        pageSize: 100
    )
);

dump($response->items);
```

Please be aware: as of now, not all endpoints are included completely or at all.
We want to continue adding more - if you notice one missing that you need...

Feel free to open a pull request!

###  Health Score

47

—

FairBetter than 94% of packages

Maintenance89

Actively maintained with recent releases

Popularity17

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity63

Established project with proven stability

 Bus Factor1

Top contributor holds 100% 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

Recently: every ~42 days

Total

28

Last Release

56d ago

Major Versions

0.0.5 → 1.0.02024-07-30

### Community

Maintainers

![](https://www.gravatar.com/avatar/c5073fbcd72e6a2f977940e7103f3dbdfd1a80fc0f47a3a92da67e647b923877?d=identicon)[drei-d](/maintainers/drei-d)

---

Top Contributors

[![vollborn](https://avatars.githubusercontent.com/u/67763683?v=4)](https://github.com/vollborn "vollborn (53 commits)")

---

Tags

apijtljtl-wawilaravelphp

### Embed Badge

![Health badge](/badges/drei-d-laravel-jtl-api/health.svg)

```
[![Health](https://phpackages.com/badges/drei-d-laravel-jtl-api/health.svg)](https://phpackages.com/packages/drei-d-laravel-jtl-api)
```

###  Alternatives

[darkaonline/l5-swagger

OpenApi or Swagger integration to Laravel

2.9k34.0M112](/packages/darkaonline-l5-swagger)[echolabsdev/prism

A powerful Laravel package for integrating Large Language Models (LLMs) into your applications.

2.3k388.3k10](/packages/echolabsdev-prism)[sburina/laravel-whmcs-up

WHMCS API client and user provider for Laravel

271.3k](/packages/sburina-laravel-whmcs-up)

PHPackages © 2026

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