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 toaddressName(string, required): Display name of that addressadrNr(string, required): Address number of that addressdistributorId(string, required): The distributor's own IDsource(string, required): Distributor (lower case, e.g. egis, ingram)updatedAt(string (date-time), required): Time of the last changedistributorName(string): Name of the distributor
Example 200 answer:
{
"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
curl -X GET 'https://api.mbcom.cloud/api/masterdata/distributor-ids' \
-H "Authorization: Bearer $ACCESS_TOKEN"