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): Monthdueis evaluated for (dueMonthparameter, defaultmonth).dueYear(integer): Yeardueis 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:
{
"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
curl -X GET 'https://api.mbcom.cloud/api/trade/v1/msp/subscriptions' \
-H "Authorization: Bearer $ACCESS_TOKEN"