## 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 of `manufacturerPartNumber`, `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 of `manual`, `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:

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

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