> For the complete documentation index, see [llms.txt](https://www.boxhero.io/docs/llms.txt). Every page is available as Markdown by appending `.md` to its URL; this page is [Markdown](https://www.boxhero.io/docs/de/developers/api/reference/partners.md).

# Partners

> Business partners — suppliers and customers used in Stock In and Stock Out transactions.

## Das Partner-Objekt

Partner — a supplier or customer used as the counterparty on Stock In and Stock Out transactions.

- `id` (integer, minimum 0, maximum 2147483647, erforderlich): Partner id.
- `type` (number, erforderlich): Partner classification. `0` = supplier (used in Stock In transactions), `1` = customer (used in Stock Out transactions).

  Mögliche Werte: `0`, `1`
- `name` (string, erforderlich): Partner display name.
- `phone` (string, erforderlich): Phone number. Empty string when not set.
- `email` (string, erforderlich): Email address. Empty string when not set.
- `address` (string, erforderlich): Postal address. Empty string when not set.
- `memo` (string, erforderlich): Free-text memo. Empty string when not set.

Beispiel

```json
{
  "id": 431485,
  "type": 0,
  "name": "Acme Supply Co.",
  "phone": "+1-415-555-0101",
  "email": "orders@acme-supply.example.com",
  "address": "123 Market St, San Francisco, CA 94103",
  "memo": ""
}
```

## Endpunkte

- [List partners](https://www.boxhero.io/docs/de/developers/api/reference/partners/list-partners) `GET /v1/partners`
- [Create a partner](https://www.boxhero.io/docs/de/developers/api/reference/partners/create-partner) `POST /v1/partners`
- [Get a partner](https://www.boxhero.io/docs/de/developers/api/reference/partners/get-partner) `GET /v1/partners/{partner_id}`
- [Update a partner](https://www.boxhero.io/docs/de/developers/api/reference/partners/update-partner) `PUT /v1/partners/{partner_id}`
- [Delete a partner](https://www.boxhero.io/docs/de/developers/api/reference/partners/delete-partner) `DELETE /v1/partners/{partner_id}`