## 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:

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

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