ConnectCloud Developers

List the provider customers to clarify (tenant:trade:msp:read)

GET /api/trade/v1/msp/customers/open

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

Provider customers without a customer mapping, or with only a suggestion (suggestion), that no contract assigns by its CSP tenant id. A person takes the suggestion or picks an existing address (PUT /api/trade/v1/msp/mappings/customers, several at once: POST /api/trade/v1/msp/customers/decide).

Responses

  • 200 The open provider customers, by provider and name. (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 MspOpenProviderCustomer)

Example 200 answer:

{
  "items": [
    {
      "city": "Passau",
      "contact": {
        "email": "josef@baeckerei-sonnleitner.example",
        "firstName": "Josef",
        "lastName": "Sonnleitner"
      },
      "countryCode": "DE",
      "firstSeenAt": "2026-11-02T05:01:00Z",
      "lastSeenAt": "2026-11-18T13:01:30Z",
      "name": "Bäckerei Sonnleitner GmbH",
      "postalCode": "94032",
      "provider": "sophos",
      "sourceCustomer": "6f1e2d3c-4b5a-4968-8776-a5b4c3d2e1f0",
      "street": "Hauptstraße 55",
      "subscriptions": [
        {
          "product": "Sophos Intercept X Advanced",
          "quantity": 9,
          "sku": "CIXA0UDAC",
          "status": "ACTIVE",
          "unit": "Gerät"
        }
      ],
      "suggestion": {
        "addressId": "3c5e7a91-2b4d-4f6a-8c1e-5d7f9a0b1c03",
        "addressName": "Bäckerei Sonnleitner GmbH",
        "adrNr": "20003",
        "customerNumber": "10003",
        "matchedBy": "name+address",
        "provider": "sophos",
        "source": "suggested",
        "sourceCustomer": "6f1e2d3c-4b5a-4968-8776-a5b4c3d2e1f0",
        "updatedAt": "2026-11-18T13:01:30Z"
      }
    }
  ]
}

Example request

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

View as Markdown · Interactive reference · OpenAPI