ConnectCloud Developers

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:

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

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

View as Markdown · Interactive reference · OpenAPI