Release Notes¶

This is the production release of the Marketplace API version 1.6.

Since the previous release, there have been updates to both the API and its documentation.

In this document:

Marketplace API version 1.6 update (January 13, 2022)¶

Procedures in a /subscriptions/{id} request were improved to avoid a 404 response.
An additional parameter was added: Partner Attestation of No Self Dealing. It is required by Microsoft for all Microsoft 365 orders.

A new endpoint to access service plans was added: /plans * A GET request to /plans will list all service plans. * A GET request to /plans/{id} will return plan details and available upgrades for this plan.
When updating a subscription, you can now schedule and provision the changes on its renewal date using the new property "scheduledOn" : "renewal".
A new property, billingModel, which identifies the billing model of a product, is now returned when viewing plans or products (available in these requests: GET /plans, GET plans/ {id}, GET /products). If the billing model is specified when placing a change order, only the products with that billing model will be affected by this request (available for these requests: POST /orders, POST /orders/estimation, POST /parameters/validation).

An incorrect country code could be passed to domainValidation when placing an order for Microsoft 365.
No currency was returned for subscriptions that have MPNs with zero prices.
When filling out an address, the state field was mandatory, but it is not required for all locations.
Order placement failed when a customer’s country is different from the marketplace’s country.
SubscriptionID was not displayed in the cancellation orders.