Get everything a run stored of one subscription (tenant:trade:msp:read)
GET /api/trade/v1/msp/runs/{id}/subscriptions/{subscriptionId}
Module: Trade · operationId: getMspRunSubscription · Tag: MSP billing · Auth: access token (Authorization: Bearer <accessToken>)
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
id |
path | string (uuid) | yes | |
subscriptionId |
path | string | yes | Ingram subscription id; for Sophos and MailStore the provider customer (sourceCustomer). |
Responses
- 200 The subscription (
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) - 404 Not found in the tenant. (
application/json)
Fields of the 200 answer:
addressId(string (uuid)): The masterdata address the subscription's usage is billed to (customer mapping or contract); omitted while it has none.addressName(string): The name of that address as the mapping or contract keeps itdetails(object): The answer ofGET /resellers/v7/subscriptions/{id}as Ingram sent it; missing when the run did not read it.items(array of MspUsageItem): Usage items of the subscription.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): Month (1–12) of the billing month.provider(string): MSP provider (mailstore,sophos,ingram,itc, …).quantities(array of object): Ingram: the subscription's billed quantity of every month a run collected it (sum of its usage items), oldest first – the quantity over time; Ingram's order history has amounts only. Missing without any.month(integer, required): Month (1–12) of the billing month.quantity(number, required): Quantity of the month.year(integer, required): Year of the billing month.
records(array of object): Sophos and MailStore: the records of the answers as the provider sent them – the customer's usage rows (also those without billable quantity), the MailStore instance.runId(string (uuid)): Id of the usage run.subscriptionId(string): The provider's subscription id.summary(object): The subscription's entry of the search answer (GET /resellers/v7/subscriptions/search) as Ingram sent it.year(integer): Year of the billing month.
Example 200 answer:
{
"addressId": "3c5e7a91-2b4d-4f6a-8c1e-5d7f9a0b1c02",
"addressName": "Kanzlei Hofmann \u0026 Partner Rechtsanwälte mbB",
"details": {
"billingPeriod": 1,
"billingPeriodUnit": "MONTHS",
"nextBillingDate": "2026-11-11",
"resources": [
{
"name": "Microsoft 365 Business Standard",
"quantity": 12,
"unitCost": 10.4,
"unitPrice": 12.5,
"vendorPartNumber": "CFQ7TTC0LDPB:0001"
}
],
"startDate": "2025-11-11T00:00:00",
"status": "ACTIVE",
"subscriptionId": "1700012345"
},
"items": [
{
"customerHint": "20002",
"id": "0a1b2c3d-4e5f-4a6b-8c7d-9e0f1a2b3c01",
"month": 10,
"provider": "ingram",
"quantity": 12,
"runId": "5d6e7f8a-9b0c-4d1e-8f2a-3b4c5d6e7f03",
"sourceCustomer": "1100430325",
"sourceCustomerName": "Kanzlei Hofmann \u0026 Partner Rechtsanwälte mbB",
"sourceName": "Microsoft 365 Business Standard",
"sourceRef": "1700012345",
"sourceSku": "CFQ7TTC0LDPB:0001/P1YM",
"year": 2026
}
],
"month": 10,
"provider": "ingram",
"quantities": [
{
"month": 8,
"quantity": 10,
"year": 2026
},
{
"month": 9,
"quantity": 12,
"year": 2026
},
{
"month": 10,
"quantity": 12,
"year": 2026
}
],
"runId": "5d6e7f8a-9b0c-4d1e-8f2a-3b4c5d6e7f03",
"subscriptionId": "1700012345",
"summary": {
"endCustomerId": "1100430325",
"endCustomerName": "Kanzlei Hofmann \u0026 Partner Rechtsanwälte mbB",
"quantity": 12,
"status": "ACTIVE",
"subscriptionId": "1700012345",
"subscriptionName": "Microsoft 365 Business Standard"
},
"year": 2026
}
Example request
curl -X GET 'https://api.mbcom.cloud/api/trade/v1/msp/runs/3f2b8c1e-7d4a-4e9b-9c2a-5b1d6e8f0a12/subscriptions/string' \
-H "Authorization: Bearer $ACCESS_TOKEN"