## List the price suggestions (tenant:trade:msp:read, tenant:trade:msp:write, tenant:trade:msp:approve, tenant:masterdata:read or tenant:masterdata:write)

`GET /api/trade/v1/msp/price-suggestions`

Module: Trade · operationId: `listMspPriceSuggestions` · Tag: MSP billing · Auth: access token (`Authorization: Bearer <accessToken>`)

New current Ingram prices of Microsoft articles that wait for a person. The open ones come first, at most 200;
there is no cursor. Needs any one of `tenant:trade:msp:read`, `tenant:trade:msp:write`, `tenant:trade:msp:approve`,
`tenant:masterdata:read`, `tenant:masterdata:write`.

### Parameters

| Name | In | Type | Required | Description |
|---|---|---|---|---|
| `status` | query | string |  | Only suggestions in this state. (one of `open`, `accepted`, `rejected`) |
| `article` | query | string |  | Only suggestions of this article number. |

### Responses

- **200** Suggestions (`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:

- `items` (array of MspPriceSuggestion, required)
  - `articleNumber` (string, required): Article number in masterdata.
  - `id` (string (uuid), required): Id of the suggestion.
  - `month` (integer, required): Billing month in which the change was found.
  - `provider` (string, required): The provider the price comes from.
  - `skuKey` (string, required): The provider's SKU key of the article.
  - `status` (string, required): Status of the suggestion (`open`, `accepted`, `rejected`). (one of `open`, `accepted`, `rejected`)
  - `updatedAt` (string (date-time), required): When the suggestion last changed.
  - `year` (integer, required): Billing year in which the change was found.
  - `articleId` (string (uuid)): The masterdata article.
  - `currency` (string): Currency (ISO 4217).
  - `decidedAt` (string (date-time)): When it was accepted or rejected.
  - `decidedBy` (string): Who decided; missing while open.
  - `newPurchase` (number): Suggested purchase price.
  - `newSales` (number): Suggested sales price.
  - `oldPurchase` (number): Purchase price now in masterdata.
  - `oldSales` (number): Sales price now in masterdata.
  - `priceSince` (string (date-time)): The new price applies since.
  - `subscriptionId` (string): The subscription the price was read from.
  - `supplierAddressId` (string (uuid)): Masterdata address of the supplier.

Example 200 answer:

```json
{
  "items": [
    {
      "articleId": "4b7d9f13-5e6a-4c8b-a1d2-3e4f5a6b7f21",
      "articleNumber": "MSFTCFQ7TTC0LCHC0002P1YM",
      "currency": "EUR",
      "id": "6e7f8a9b-0c1d-4e2f-8a3b-4c5d6e7f8a01",
      "month": 10,
      "newPurchase": 18,
      "newSales": 21.6,
      "oldPurchase": 17.2,
      "oldSales": 20.6,
      "priceSince": "2026-11-01T00:00:00Z",
      "provider": "ingram",
      "skuKey": "CFQ7TTC0LCHC:0002/P1YM",
      "status": "open",
      "subscriptionId": "1700012399",
      "supplierAddressId": "6d8f0a12-3c4e-4a5b-9d6f-7e8a9b0c1d10",
      "updatedAt": "2026-11-01T05:04:40Z",
      "year": 2026
    }
  ]
}
```

### Example request

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