## List distributor IDs (tenant:masterdata:read)

`GET /api/masterdata/distributor-ids`

Module: Master data · operationId: `listDistributorIds` · Tag: Distributor IDs · Auth: access token (`Authorization: Bearer <accessToken>`)

Ordered by source and distributor ID. An invalid `source` returns an empty list.

### Parameters

| Name | In | Type | Required | Description |
|---|---|---|---|---|
| `source` | query | string |  | Only this distributor source |

### Responses

- **200** Distributor IDs (`application/json`)
- **401** Missing, invalid or expired token (empty body)
- **403** The token lacks the permission or carries no tenant (`application/json`)

Fields of the 200 answer:

- `items` (array of DistributorID, required)
  - `addressId` (string (uuid), required): Supplier address the distributor ID maps to
  - `addressName` (string, required): Display name of that address
  - `adrNr` (string, required): Address number of that address
  - `distributorId` (string, required): The distributor's own ID
  - `source` (string, required): Distributor (lower case, e.g. egis, ingram)
  - `updatedAt` (string (date-time), required): Time of the last change
  - `distributorName` (string): Name of the distributor

Example 200 answer:

```json
{
  "items": [
    {
      "addressId": "3c5e7a9c-1d3f-4b5a-9c7e-1a3c5e7a9c1e",
      "addressName": "Alpenhotel Seeblick GmbH \u0026 Co. KG",
      "adrNr": "10001",
      "distributorId": "700123",
      "distributorName": "EGIS Computer Service-Center GmbH",
      "source": "egis",
      "updatedAt": "2026-05-20T11:40:00Z"
    }
  ]
}
```

### Example request

```bash
curl -X GET 'https://api.mbcom.cloud/api/masterdata/distributor-ids' \
  -H "Authorization: Bearer $ACCESS_TOKEN"
```
