List the article mappings (tenant:trade:msp:read)
GET /api/trade/v1/msp/mappings/articles
Module: Trade · operationId: listMspArticleMappings · Tag: MSP billing · Auth: access token (Authorization: Bearer <accessToken>)
Responses
- 200 Mappings (
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 MspArticleMapping)articleNumber(string, required): Masterdata article that is sold. (max length 100)provider(string, required): MSP provider (mailstore,sophos,ingram,itc, …). (max length 32)sourceSku(string, required): The provider's SKU. (max length 200)id(string (uuid), read-only): Id of the mapping.matchedBy(string, read-only): Rule of an automatic mapping: the SKU is the article's manufacturer part number, the bare Microsoft SKU (without term) is the article's manufacturer part number (a fallback replaced by the SKU and term's own article once that exists), the article has the Microsoft or Sophos SKU's number, or the article was created for it. (one ofmanufacturerPartNumber,manufacturerPartNumberBare,articleNumber,created)name(string): Line text; empty: the article's name. (max length 300)source(string, read-only): Every save through the API is manual, also a save of an automatic mapping. (one ofmanual,auto)unitPrice(number): Net price; empty: the contract's usage position, else the article's price.updatedAt(string (date-time), read-only): When the mapping was last saved.
Example 200 answer:
{
"items": [
{
"articleNumber": "MSFTCFQ7TTC0LDPB0001P1YM",
"id": "4c5d6e7f-8a9b-4c0d-9e1f-2a3b4c5d6e01",
"matchedBy": "articleNumber",
"name": "Microsoft 365 Business Standard 1YM",
"provider": "ingram",
"source": "auto",
"sourceSku": "CFQ7TTC0LDPB:0001/P1YM",
"updatedAt": "2026-08-01T05:05:00Z"
},
{
"articleNumber": "CL-3003",
"id": "4c5d6e7f-8a9b-4c0d-9e1f-2a3b4c5d6e02",
"name": "E-Mail-Archivierung je Postfach, monatlich",
"provider": "mailstore",
"source": "manual",
"sourceSku": "MB-MAILSTORE",
"unitPrice": 2.5,
"updatedAt": "2026-03-02T09:00:00Z"
}
]
}
Example request
curl -X GET 'https://api.mbcom.cloud/api/trade/v1/msp/mappings/articles' \
-H "Authorization: Bearer $ACCESS_TOKEN"