Edit in GitHubLog an issue

Release notes

API changes

December 11, 2025

Mid-term upgrades

Partners can upgrade customer subscriptions during the active term, without waiting for the renewal date.

New capabilities

  • Upgrade path discovery Partners can retrieve valid upgrade paths using the new GET Offer Switch Paths API, filtered by market segment, country, and language.

  • Preview switch order A new orderType value, PREVIEW_SWITCH, has been added to the Create Order API. This allows partners to generate upgrade quotes before placing a switch order.

  • Switch order execution Partners can place upgrade orders using the SWITCH order type, specifying both the "From" and "To" product details. The API supports automatic user reassignment via the reassign-users=true query parameter.

  • Upgrade reversion Partners can revert a switch order within 14 days using the new REVERT_SWITCH and PREVIEW_REVERT_SWITCH order types. This restores the original subscription and de-provisions the upgraded product.

  • Partial and full upgrades The system supports both full and partial upgrades, including seat expansions and product transitions (example: Acrobat Standard to Acrobat Pro).

  • Enhanced Error Handling

    Several new error codes have been introduced to provide clear feedback for mid-term upgrade scenarios, including:

    • 2149: Quantity mismatch
    • 2150: Switch path validity check failed
    • 2151: Quantity exceeded
    • 2152: Multiple line items not supported
    • 2153: Line item and cancelling line item mismatch
    • 2154: Upgrade not supported
    • 3115: Invalid subscription

Read more about Mid-term upgrades.

November 11, 2025

Change to reseller change approval code validity

  • The reseller approval code is now valid for 7 days, an increase from the previous 72 hours. This code is emailed to all customer administrators, who then share it with the new reseller to authorize the transfer. Read more about Reseller change process.

Display source of the Order in Create Order and Get Order API responses

  • Added the source parameter in the responses of Create Order and Get Order APIs to indicate the origin of the order. Possible values are: API or System.

Changes to Get Customer List and Get Reseller List APIs

Display deploymentID and currencyCode in Reseller Transfer API responses

Base part number in the GET Open Acquisitions API response

  • Introduced the baseOfferId parameter in the response payload of the GET Open Acquisitions (aka GET Licenses Pending Partner Order) API. This parameter in the API response allows partners to match the correct part number using product name details from notification emails and proceed with order placement.

    Read more about Get licenses pending partner order API.

August 22, 2025

Preview with pricing

  • Partners can now retrieve the pricing details in the Preview Order and Preview Renewal APIs by setting the fetch-price query parameter to true in the request URL. This returns real-time partner pricing details for Adobe products, helping partners and resellers better estimate how much Adobe will invoice for an order.

    • Introduced pricing object in the lineItem level of the Preview Order and Preview Renewal API responses.
    • Added pricingSummary object to provide summarized pricing details of all line items.
    • Introduced new fetch-price query parameter for both Preview Order and Preview Renewal scenarios.
    • Introduced new proratedDays parameter in the response of Preview Order and Preview Renewal APIs to indicate the number of days for which the order will be invoiced. This parameter appears only when the fetch-price parameter is set to true in the request.
    • A new error code (2148) has been introduced for the Preview Order and Preview Renewal APIs to handle pricing requests involving multiple currencies.

    Read more about preview with pricing.

Get Customer List and Get Reseller List APIs

  • The Get Reseller List API enables partners to retrieve a list of resellers linked to a distributor.
    • The API supports filtering by reseller status and sorting by creation date or reseller name.
      Read more about Get Reseller List API.
  • The Get Customer List API enables partners to retrieve customer accounts associated with a specific reseller.
    • This API is essential for partners who manage customer portfolios and require precise, real-time access to customer data for quoting, reporting, and renewal planning.
      Read more about Get Customer List API.

June 19, 2025

Fetch Price List

May 09, 2025

Manage Flexible Discounts

  • Partners can access flexible discounts tailored to specific products, market segments, and countries, and apply them during the order process. Read more about how to manage flexible discounts.
    The major API changes include:

    • Introduced the GET /v3/flex-discounts API to get the list of available flexible discounts.
    • Preview Order API returns the applicable flexible discounts for the customer.
    • Partners can place the order by applying the flexible discount code received.
    • Introduced new error codes specific to Flexible Discounts.

Fetch Recommendations

  • Recommendations API enables VIP Marketplace partners to deliver intelligent, personalized, and in-context product recommendations, enhancing customer experience through upsell, cross-sell, and add-on opportunities. Read more about how to manage recommendations.
    Major API changes include:
    • Partners can use POST /v3/recommendations API to fetch the relevant product recommendations.
    • Both Preview Order and Preview Renewal APIs fetch the applicable recommendations.
    • Both Get Subscriptions and Get Order APIs can fetch recommendations.
    • Introduced new error codes specific to recommendations.

January 23, 2025

Migrate High Volume Discount (HVD) customers from VIP

Manage High Growth Offers

  • Introduced High Growth Offers for existing Acrobat Pro customers. These offers will replace the current High Volume Discounting program that exists in VIP. See Manage High Growth Offers for more details.

Earlier releases in 2024

  • Included customer's VIP renewal status within migration preview API response. See Preview Offer for more details.

  • Ability to place renewal orders after anniversary date

    Added allowedActions field in the Get All Subscriptions for a Customer API to indicate the subscriptions that can be selected for manual renewals. See Get Subscription Details for more information.

  • The newly introduced RENEWAL order type in the Create Order API is used for renewals that are initiated after the anniversary date. See Create Order Scenarios for more details.

  • Enabling Global customers for Create Subscription.

    Global customers can now use Create Subscription API to create scheduled subscriptions. See Create Subscriptions for more details.

  • Create and manage linked memberships

    Adding support for creating and managing linked memberships that facilitates combining purchases across linked customer accounts to achieve better volume discounts. See Manage linked memberships for more information.

  • “Late renewals” or “Renewal” Order Type

    Introducing a new Order Type for partners to place “late renewal” after anniversary date. See Create Order for more information.

  • Create orders

    Implemented a validation to prevent partners from placing new orders before the subscription’s anniversary date. If a partner attempts to place an order before this date, an error message will appear as the response.

  • Worldwide offers:

    • Added ability to enable a customer for worldwide (global) sales
    • Added ability to create “Deployments” for a customer to purchase worldwide offers
    • Added an optional currencyCode to the order lineItem level to support global deployments
    • Added deploymentId to order lineItem (read/write)
    • Added deploymentId and currencyCode to subscription resource (read only)
    • Added deploymentId and currencyCode to transfer resource (read only)

  • Included 3yc info in preview migration and preview/execution of reseller change API calls.

  • Create Subscription:

    • Added ability to create future dated subscription that would become active on next anniversary date. See Create Subscription for more information.

  • Added a new API to fetch all customers (under a given reseller) who have added seats via Adobe’s Admin console.

  • Added a new API to fetch all seats/licenses added by a given customer via admin console.

  • These APIs will inform our partners to place corresponding orders backing the seats added by the customers via admin console.

  • Added new Error Code for Preview / Create Transfer response. See Status Codes & Error Handling for more information.

  • Added self-service capability for a customer and partner to move between resellers/partners. See Reseller Change Process for more information.

Sandbox changes

Was this helpful?

Community

Support

Adobe Developer

  • Privacy
  • Terms of Use
  • Do not sell or share my personal information
  • AdChoices
Copyright © 2025 Adobe. All rights reserved.