PHPackages                             andyfraussen/laravel-uitdatabank-client - 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. [Search &amp; Filtering](/categories/search)
4. /
5. andyfraussen/laravel-uitdatabank-client

ActiveLibrary[Search &amp; Filtering](/categories/search)

andyfraussen/laravel-uitdatabank-client
=======================================

A fluent Laravel client for publiq UiTdatabank APIs (Search available, more on roadmap)

v1.0(4mo ago)00MITPHPPHP ^8.3CI passing

Since Feb 12Pushed 4mo agoCompare

[ Source](https://github.com/andyfraussen/laravel-uitdatabank-client)[ Packagist](https://packagist.org/packages/andyfraussen/laravel-uitdatabank-client)[ Docs](https://github.com/andyfraussen/laravel-uitdatabank-client)[ RSS](/packages/andyfraussen-laravel-uitdatabank-client/feed)WikiDiscussions master Synced today

READMEChangelogDependencies (6)Versions (3)Used By (0)

Laravel UiTdatabank Client
==========================

[](#laravel-uitdatabank-client)

[![Latest Version on Packagist](https://camo.githubusercontent.com/71f9e62309967f0596c555dc5259eab30ac2b329b1f3e30ac7d832e2326d26e8/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f616e6479667261757373656e2f6c61726176656c2d7569746461746162616e6b2d636c69656e742e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/andyfraussen/laravel-uitdatabank-client)[![Total Downloads](https://camo.githubusercontent.com/4528924c4b405b68905e3c9fc73be7d3f6fd1a9a892fef162a1a5788b3fe97c2/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f616e6479667261757373656e2f6c61726176656c2d7569746461746162616e6b2d636c69656e742e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/andyfraussen/laravel-uitdatabank-client)[![License](https://camo.githubusercontent.com/cf88e9bda28ed3fe8f86674bfc724e4116609f28de75a6417dc6fa171bf5c692/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f616e6479667261757373656e2f6c61726176656c2d7569746461746162616e6b2d636c69656e742e7376673f7374796c653d666c61742d737175617265)](LICENSE.md)

A fluent Laravel client for **UiTdatabank APIs**.

Current module support:

- `Search API` (available now)

Search endpoints currently supported:

- `GET /offers`
- `GET /events`
- `GET /places`
- `GET /organizers`

Roadmap
-------

[](#roadmap)

- Search API
- Taxonomy API (`GET /terms`)
- Entry API

Features
--------

[](#features)

- Laravel service provider + facade auto-discovery
- Fluent query builder (`newQuery()->q()->limit()->where()->get()`)
- Typed DTO responses (`SearchResultData`, `SearchItemData`)
- Config-based credentials (`x-client-id` + `x-api-key`)
- Runtime credential override for multi-tenant scenarios
- Problem+JSON exception mapping

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

[](#installation)

```
composer require andyfraussen/laravel-uitdatabank-client
```

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

[](#requirements)

- PHP `8.3+`
- Laravel `12`

Publish the config file:

```
php artisan vendor:publish --provider="AndyFraussen\UiTdatabankClient\UiTdatabankServiceProvider" --tag="uitdatabank-config"
```

Configuration
-------------

[](#configuration)

Set credentials in `.env`:

```
UITDATABANK_ENV=testing
UITDATABANK_CLIENT_ID=your-client-id
UITDATABANK_API_KEY=your-api-key
UITDATABANK_TIMEOUT=30
UITDATABANK_RETRY_TIMES=3
UITDATABANK_RETRY_SLEEP=100

# Optional: override the Taxonomy API base URL (defaults to https://taxonomy.uitdatabank.be)
UITDATABANK_TAXONOMY_URL=https://taxonomy.uitdatabank.be
```

Available environments:

- `testing` -&gt; `https://search-test.uitdatabank.be`
- `production` -&gt; `https://search.uitdatabank.be`

Usage
-----

[](#usage)

### Basic search

[](#basic-search)

```
use AndyFraussen\UiTdatabankClient\Facades\UiTdatabank;

$result = UiTdatabank::events()->search([
    'q' => 'brussel',
    'limit' => 10,
]);

$total = $result->totalItems;
$items = $result->member;
```

### Fluent query builder

[](#fluent-query-builder)

```
$result = UiTdatabank::offers()
    ->newQuery()
    ->q('muziek')
    ->limit(20)
    ->start(0)
    ->embed(['location', 'organizer'])
    ->where('sort[created]', 'desc')
    ->get();
```

### Taxonomy

[](#taxonomy)

```
$terms = UiTdatabank::taxonomy()->terms();

foreach ($terms->terms as $term) {
    echo $term->name->nl; // e.g. "Concert"
}
```

### Runtime credential override

[](#runtime-credential-override)

```
$result = UiTdatabank::withCredentials($clientId, $apiKey)
    ->places()
    ->search(['q' => 'gent', 'limit' => 5]);
```

Response DTOs
-------------

[](#response-dtos)

`SearchResultData` contains:

- `context` (`@context`)
- `type` (`@type`)
- `itemsPerPage`
- `totalItems`
- `member` (array of `SearchItemData`)
- `raw` (original response array)

`SearchItemData` contains:

- `id` (`@id`)
- `type` (`@type`)
- `raw` (original item payload)

Error handling
--------------

[](#error-handling)

Non-2xx responses throw package exceptions:

- `AuthenticationException` (`401`)
- `AuthorizationException` (`403`)
- `NotFoundException` (`404`)
- `DuplicateException` (`409`, when applicable)
- `ValidationException` (`400` validation problem types)
- Fallback: `UiTdatabankException`

```
use AndyFraussen\UiTdatabankClient\Exceptions\AuthenticationException;

try {
    $result = UiTdatabank::events()->search(['q' => 'antwerpen']);
} catch (AuthenticationException $e) {
    report($e);
}
```

Testing
-------

[](#testing)

```
composer test
```

License
-------

[](#license)

The MIT License (MIT). See [LICENSE.md](LICENSE.md).

###  Health Score

35

—

LowBetter than 77% of packages

Maintenance76

Regular maintenance activity

Popularity0

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity51

Maturing project, gaining track record

 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

Unknown

Total

1

Last Release

141d ago

### Community

Maintainers

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

---

Top Contributors

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

---

Tags

searchlaraveltaxonomyentryUiTdatabankPubliq

###  Code Quality

TestsPest

### Embed Badge

![Health badge](/badges/andyfraussen-laravel-uitdatabank-client/health.svg)

```
[![Health](https://phpackages.com/badges/andyfraussen-laravel-uitdatabank-client/health.svg)](https://phpackages.com/packages/andyfraussen-laravel-uitdatabank-client)
```

###  Alternatives

[psalm/plugin-laravel

Psalm plugin for Laravel

3355.3M346](/packages/psalm-plugin-laravel)[laravel/scout

Laravel Scout provides a driver based solution to searching your Eloquent models.

1.7k55.0M618](/packages/laravel-scout)[laravel/mcp

Rapidly build MCP servers for your Laravel applications.

77022.3M151](/packages/laravel-mcp)[defstudio/telegraph

A laravel facade to interact with Telegram Bots

816333.8k3](/packages/defstudio-telegraph)[api-platform/laravel

API Platform support for Laravel

58171.5k14](/packages/api-platform-laravel)[simplestats-io/laravel-client

Server-side analytics for Laravel that follows the full funnel from visit to registration to payment, attributed to the channel that drove it. Revenue, MRR, churn and ad-spend profit (ROAS/CAC) per channel. GDPR compliant, ad-blocker proof.

5021.9k](/packages/simplestats-io-laravel-client)

PHPackages © 2026

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