## List the subscriptions the runs of a month read (tenant:trade:msp:read)

`GET /api/trade/v1/msp/subscriptions`

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

Lists what each succeeded run of the month read (one run per provider and month), in provider order, with the number of usage items the run made of each subscription. Failed and running runs and providers without a subscription view are left out. `due` tells whether the month `dueMonth` (default `month`) bills the subscription: it needs usage items and is no trial; Sophos and MailStore customers and monthly Ingram subscriptions are due every month; longer Ingram billing periods in the month of the next billing date and a whole number of periods before or after it (without a next billing date: after the start date); without a date the subscription counts as due. The month's MSP drafts bill only the usage of the subscriptions due in it; the others stay assigned but go on no invoice.

### Parameters

| Name | In | Type | Required | Description |
|---|---|---|---|---|
| `month` | query | string |  | Billing month `YYYY-MM` (Europe/Berlin); default the previous month. |
| `dueMonth` | query | string |  | Month `YYYY-MM` for which `due` is evaluated; default the month of the runs (`month`). Malformed answers `400`. |

### Responses

- **200** Subscriptions (`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:

- `dueMonth` (integer): Month `due` is evaluated for (`dueMonth` parameter, default `month`).
- `dueYear` (integer): Year `due` is evaluated for.
- `month` (integer): Month (1–12) of the billing month.
- `subscriptions` (array of MspMonthSubscriptionRow): Subscriptions the runs of the month read.
- `year` (integer): Year of the billing month.

Example 200 answer:

```json
{
  "dueMonth": 10,
  "dueYear": 2026,
  "month": 10,
  "subscriptions": [
    {
      "billingPeriod": 1,
      "billingPeriodUnit": "MONTHS",
      "due": true,
      "endCustomer": "Kanzlei Hofmann \u0026 Partner Rechtsanwälte mbB",
      "endCustomerId": "1100430325",
      "hasDetails": true,
      "isTrial": false,
      "items": 1,
      "nextBillingDate": "2026-11-11",
      "planName": "Microsoft 365 Business Standard",
      "provider": "ingram",
      "quantity": 12,
      "runId": "5d6e7f8a-9b0c-4d1e-8f2a-3b4c5d6e7f03",
      "startDate": "2025-11-11T00:00:00",
      "status": "ACTIVE",
      "subscriptionId": "1700012345"
    },
    {
      "billingPeriod": 1,
      "billingPeriodUnit": "YEARS",
      "due": false,
      "endCustomer": "Donau Maschinenbau AG",
      "endCustomerId": "1100430411",
      "hasDetails": true,
      "isTrial": false,
      "items": 1,
      "nextBillingDate": "2027-02-28",
      "planName": "Windows Server 2025 Standard ESU",
      "provider": "ingram",
      "quantity": 2,
      "runId": "5d6e7f8a-9b0c-4d1e-8f2a-3b4c5d6e7f03",
      "startDate": "2026-02-28T00:00:00",
      "status": "ACTIVE",
      "subscriptionId": "1700012377"
    }
  ],
  "year": 2026
}
```

### Example request

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