Skip to main content

Products, payment plans and discounts

In order to understand what products are available for purchase, what editions each of these products offer, and the discounts available for these products, it is important to know about a few more AppDirect API methods. The methods described below will allow you to get the paymentPlanId and discountId necessary to create a subscription through the API.  Note that these ids are also available through the UI.

Read product list

The Product Listing API returns all products within the marketplace catalog and information about respective products. 

URL endpoint: /api/marketplace/v1/listing

Method: GET

Parameters: You can use all supported parameters in combination, as in this example that combines 'q' and 'count' -- https://www.appdirect.com/api/marketplace/v1/listing?q=sampleapp&count=5

ParameterDescription
typeSet of: WEB_APP, WEB_APP_MANUAL_SETUP, TEMPLATE, DESIGN_ELEMENT, MODULE, EMBEDDED_VIDEO, BUNDLE, DOWNLOADABLE_BUNDLE
filtersSet of: FEATURED, POPULAR, STAFFPICK, FREE, PAID
orderOrder of which apps will be displayed. One of: NEWEST_FIRST, ALPHABETICAL, POPULARITY
countNumber of products returned
cQuery category IDs
sQuery subcategory IDs
iQuery customer IDs
aQuery attribue IDs
qQuery search string

HTTP Status Codes: 200 OK on success

Read product profile

The Product Profile API returns the full details of a product in order to show the product profile on the marketplace. 

URL endpoint: /api/marketplace/v1/products/<productId>

Method: GET

Parameters: <productId> the unique product identifier provided by the channel

HTTP Status Codes: 200 OK on success; 404 Not Found if no product with the specified productId exists in the system.

List discounts

The Discount Listing API returns all discounts available within the marketplace. Additional information can be found here.

URL endpoint: /api/channel/v1/discounts

Method: GET

Parameters: The optional parameters are shown below.

ParameterDescription
code4-255 characters
sortFieldCODE, APPLICATION, REDEMPTIONS, START_DATE, END_DATE, or CREATED_ON; defaults to CREATED_ON
sortOrderASC or DESC; defaults to ASC
startInteger values; defaults to 0
count0-250; defaults to 250

HTTP Status Codes: 200 OK on success

Was this page helpful?