# listBusinessPartners

## Overview

Returns the shared business partner directory, one row per partner. Searches partner
names and filters by the existence of customer or supplier accounts before applying
offset/limit pagination. Inactive accounts still qualify as relationships. Multiple
accounts, including accounts in different companies, never duplicate directory rows.

Input: optional `search`, `role` (ALL / CUSTOMER / SUPPLIER), `offset` (default 0),
`limit` (default 25, maximum 100). Output: `items` with shared identity/status and
`isCustomer` / `isSupplier`, plus the total number of matching partners.

## Modules Commands Used

- None. Delegates the read to `business-partner.queries.listBusinessPartners`; the resolver contains no SQL.

## Exception Handling

| Error Code | Description |
| --- | --- |
| DomainError | Authentication is required, or role/pagination is invalid |