## 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 it
- `details` (object): The answer of `GET /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:

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

```bash
curl -X GET 'https://api.mbcom.cloud/api/trade/v1/msp/runs/3f2b8c1e-7d4a-4e9b-9c2a-5b1d6e8f0a12/subscriptions/string' \
  -H "Authorization: Bearer $ACCESS_TOKEN"
```
