ConnectCloud Developers

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:

{
  "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"

View as Markdown · Interactive reference · OpenAPI