ConnectCloud Developers

List the customer mappings (tenant:trade:msp:read)

GET /api/trade/v1/msp/mappings/customers

Module: Trade · operationId: listMspCustomerMappings · Tag: MSP billing · Auth: access token (Authorization: Bearer <accessToken>)

Responses

  • 200 Mappings (application/json)
  • 401 No valid session or bearer token (no body).
  • 403 Missing permission, no active tenant in the token, or a missing CSRF token on a cookie write. (application/json)

Fields of the 200 answer:

  • items (array of MspCustomerMapping)
    • addressId (string (uuid), required): Masterdata address that is billed.
    • provider (string, required): MSP provider (mailstore, sophos, ingram, itc, …). (max length 32)
    • sourceCustomer (string, required): The provider's customer (id or name). (max length 200)
    • addressName (string): Name of the masterdata address. (max length 300)
    • adrNr (string): Adressnummer of the masterdata address. Optional in a PUT (taken from the address the person picked); without it a save to the same address keeps the stored number, a save to another address clears it. AutoMap fills it from masterdata's match. (max length 64)
    • contractId (string (uuid)): Contract the usage belongs to (its usage positions set prices).
    • customerNumber (string): Kundennummer of the masterdata address, the number providers send (Sophos assignedAccountIdentifier "11141 | Name", MailStore instance id "k11141"). Optional in a PUT, same rules as adrNr. (max length 64)
    • id (string (uuid), read-only): Id of the mapping.
    • matchedBy (string, read-only): Rule of an automatic mapping or a suggestion (adrNr: an Ingram end customer whose Custom_Account_ID is our address number). created: only on mappings of earlier versions, which created the masterdata address of an Ingram end customer by themselves. (one of adrNr, customerNumber+address, customerNumber, name+address, name, address, created)
    • source (string, read-only): auto: masterdata has the provider's customer number as an address's customer number, billed like a manual mapping. suggested: found by name or postal address only, assigns nothing and bills nothing until it is saved. Every save through the API is manual, also the save of an automatic mapping or a suggestion. (one of manual, auto, suggested)
    • updatedAt (string (date-time), read-only): When the mapping was last saved.

Example 200 answer:

{
  "items": [
    {
      "addressId": "3c5e7a91-2b4d-4f6a-8c1e-5d7f9a0b1c01",
      "addressName": "Alpenhotel Seeblick GmbH \u0026 Co. KG",
      "adrNr": "20001",
      "customerNumber": "10001",
      "id": "3b4c5d6e-7f8a-4b9c-8d0e-1f2a3b4c5d01",
      "matchedBy": "customerNumber",
      "provider": "sophos",
      "source": "auto",
      "sourceCustomer": "2e3f4a5b-6c7d-4e8f-9a0b-1c2d3e4f5a6b",
      "updatedAt": "2026-11-01T05:06:10Z"
    },
    {
      "addressId": "3c5e7a91-2b4d-4f6a-8c1e-5d7f9a0b1c02",
      "addressName": "Kanzlei Hofmann \u0026 Partner Rechtsanwälte mbB",
      "adrNr": "20002",
      "contractId": "0e1f2a3b-4c5d-4e6f-8a7b-9c0d1e2f3a07",
      "customerNumber": "10002",
      "id": "3b4c5d6e-7f8a-4b9c-8d0e-1f2a3b4c5d02",
      "provider": "ingram",
      "source": "manual",
      "sourceCustomer": "1100430325",
      "updatedAt": "2026-02-03T11:00:00Z"
    }
  ]
}

Example request

curl -X GET 'https://api.mbcom.cloud/api/trade/v1/msp/mappings/customers' \
  -H "Authorization: Bearer $ACCESS_TOKEN"

View as Markdown · Interactive reference · OpenAPI