## List the usage no customer is assigned to (tenant:trade:msp:read)

`GET /api/trade/v1/msp/unassigned`

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

The clarification list: usage items whose provider customer neither a customer mapping nor a contract
(`cspSubscriptionId` = the item's reference, `cspTenantId` = the provider customer) assigns, and problems that
concern no invoice (e.g. a contract without customer). Computed on request; nothing is stored.

### Parameters

| Name | In | Type | Required | Description |
|---|---|---|---|---|
| `month` | query | string |  | Billing month `YYYY-MM` (Europe/Berlin); default the previous month. |

### Responses

- **200** Unassigned usage (`application/json`)
- **400** Error (`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 MspUsageItem)
  - `customerHint` (string): Customer number the provider keeps (MailStore instance, Ingram custom account id, Sophos: the number of assignedAccountIdentifier `<number> | <name>`).
  - `id` (string (uuid)): Id of the usage item.
  - `month` (integer): Month (1–12) of the billing month.
  - `provider` (string): MSP provider (`mailstore`, `sophos`, `ingram`, `itc`, …).
  - `quantity` (number): Quantity used in the month.
  - `runId` (string (uuid)): Id of the usage run.
  - `sourceCustomer` (string): The provider's id of its customer (mapping key).
  - `sourceCustomerName` (string): The provider's name of its customer (Sophos: the name of assignedAccountIdentifier `<number> | <name>`).
  - `sourceName` (string): The provider's product name.
  - `sourceRef` (string): The provider's subscription reference.
  - `sourceSku` (string): The provider's SKU.
  - `year` (integer): Year of the billing month.
- `month` (integer)
- `problems` (array of string)
- `year` (integer)

Example 200 answer:

```json
{
  "items": [
    {
      "id": "0a1b2c3d-4e5f-4a6b-8c7d-9e0f1a2b3c21",
      "month": 10,
      "provider": "sophos",
      "quantity": 9,
      "runId": "5d6e7f8a-9b0c-4d1e-8f2a-3b4c5d6e7f02",
      "sourceCustomer": "6f1e2d3c-4b5a-4968-8776-a5b4c3d2e1f0",
      "sourceCustomerName": "Bäckerei Sonnleitner GmbH",
      "sourceName": "Sophos Intercept X Advanced",
      "sourceRef": "6f1e2d3c-4b5a-4968-8776-a5b4c3d2e1f0",
      "sourceSku": "CIXA0UDAC",
      "year": 2026
    }
  ],
  "month": 10,
  "problems": [],
  "year": 2026
}
```

### Example request

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