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(4d ago)0680—0%MITPHPPHP ^8.2

Since Jul 23Pushed 4d 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 today

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

50

—

FairBetter than 96% of packages

Maintenance99

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

4d 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

[openai-php/laravel

OpenAI PHP for Laravel is a supercharged PHP API client that allows you to interact with the Open AI API

3.7k7.0M61](/packages/openai-php-laravel)[m165437/laravel-blueprint-docs

API Blueprint Renderer for Laravel

22778.7k](/packages/m165437-laravel-blueprint-docs)[escolalms/headless-h5p

Headless H5P Laravel REST API

2731.7k2](/packages/escolalms-headless-h5p)

PHPackages © 2026

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