Product List - List By Subscription

Service:

Marketplace Catalog

API Version:

2025-05-01

Lists products for subscription.

GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Marketplace/products?api-version=2025-05-01

With optional parameters:

GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Marketplace/products?api-version=2025-05-01&language={language}&excludePublicOffersAndPublicPlans={excludePublicOffersAndPublicPlans}&$filter={$filter}&$select={$select}&$expand={$expand}&$orderBy={$orderBy}&$search={$search}

URI Parameters

Name	In	Required	Type	Description
subscriptionId	path	True	string (uuid)	The ID of the target subscription. The value must be an UUID.
api-version	query	True	string minLength: 1	The API version to use for this operation.
$expand	query		string	Expands related entities inline
$filter	query		string	Filters the results, based on a Boolean condition. Example: $filter=productType eq 'VirtualMachine'. Fields that can be filtered by are: displayName productId popularity categoryIds industryIds publisherId uniqueProductId productType operatingSystems pricingTypes publisherDisplayName longSummary summary linkedAddinsTypes description supportedProducts applicableProducts lastModifiedDateTime plan.planId plan.displayName plan.cspState plan.altStackReference plan.stackType plan.categoryIds plan.hasProtectedArtifacts plan.pricingTypes plan.summary plan.description plan.skuId plan.displayRank plan.isPrivate
$orderBy	query		string	Ordering expression for the results using OData notation. Avoid using orderby unless essential as this may impact the latency of your request. Example: $orderby=displayName desc.This API only supports ordering by a single field. Fields that can be ordered by are: lastModifiedDateTime uniqueProductId productType displayName publisherId'
$search	query		string	Optional search by display name, publisher display name, or keywords. Example $search=Microsoft
$select	query		string	Selects which properties to include in the results. Example: $select=displayName
excludePublicOffersAndPublicPlans	query		boolean	Whether to exclude public offers and public plans from the response. Default is false, which means that public offers and public plans are included in the response. If set to true, only private plans will be returned.
language	query		string	Language to search, ISO 639-1 two-letter code, possible values - 'en,cs,de,es,fr,hu,it,ja,ko,nl,pl,pt-br,pt-pt,ru,sv,tr,id,zh-hans,zh-hant'. Default is "en"

Responses

Name	Type	Description
200 OK	ProductSummaryListResult	The request has succeeded.
Other Status Codes	DiscoveryErrorPayload	An unexpected error response.

Security

azure_auth

Azure Active Directory OAuth2 Flow.

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name	Description
user_impersonation	impersonate your user account

Examples

ProductList_ListBySubscription

Sample request

HTTP

GET https://management.azure.com/subscriptions/f47ac10b-58cc-4372-a567-0e02b2c3d479/providers/Microsoft.Marketplace/products?api-version=2025-05-01&language=en&$filter=productType eq 'SaaS'&$select=displayName,uniqueProductId,productType,publisherDisplayName

Sample response

Status code:

200

{
  "value": [
    {
      "uniqueProductId": "microsoft.managedinstance_standard",
      "displayName": "Azure SQL Managed Instance",
      "publisherDisplayName": "Microsoft",
      "productType": "SaaS"
    }
  ],
  "nextLink": "https://management.azure.com/subscriptions/f47ac10b-58cc-4372-a567-0e02b2c3d479/providers/Microsoft.Marketplace/products?api-version=2025-05-01&language=en&$select=displayName,uniqueProductId,productType,publisherDisplayName&$filter=productType eq 'SaaS'&$skiptoken=W3sid..."
}

Definitions

Name	Description
Attribute	Represents a SKU attribute, which consists of a key and value. The attributes may differ across various services.
DiscoveryErrorDetails	Error details returned in DiscoveryErrorPayload
DiscoveryErrorPayload	Error payload returned by Marketplace Discovery APIs
PlanMetadata	Additional metadata
PlanSummary	Returns a subset of Plan attributes
ProductSummary	Returns a subset of Product attributes
ProductSummaryListResult	The custom response of a list operation.

Attribute

Object

Represents a SKU attribute, which consists of a key and value. The attributes may differ across various services.

Name	Type	Description
key	string	The attribute key
value	string	The attribute value

DiscoveryErrorDetails

Object

Error details returned in DiscoveryErrorPayload

Name	Type	Description
code	string	The HTTP error code
message	string	The error message

DiscoveryErrorPayload

Object

Error payload returned by Marketplace Discovery APIs

Name	Type	Description
error	DiscoveryErrorDetails	The error details object

PlanMetadata

Object

Additional metadata

Name	Type	Description
altStackReference	string	Pointing to a planId which holds the alternative stack reference
generation	string	The VM image generation (applicable to Virtual Machine products only)

PlanSummary

Object

Returns a subset of Plan attributes

Name	Type	Description
altArchitectureReference	string	The alternative architecture reference
altStackReference	string	Alternative stack reference
categoryIds	string[]	Plan CategoryIds
cspState	string	Controls plan availability and partner access within the Microsoft Cloud Solution Provider (CSP) program. OptIn - Enables all authorized Cloud Solution Provider partners to resell and deploy the product to customers OptOut - Excluded from Cloud Solution Provider program, available only through direct channels SelectiveOptIn - Available only to selected Cloud Solution Provider partners for resale and customer deployment
description	string	Plan / sku description
displayName	string	Display name of the plan / sku
displayRank	string	The order the plan is displayed in the 'Plans' table
hasProtectedArtifacts	boolean	Set to true if plan has artifacts that are to be hidden for non authenticated users
hasRi	boolean	Indication whether the SKU supports reservations
isPrivate	boolean	Indication that the plan is accessible to restricted audience only
metadata	PlanMetadata	Expanded plan/SKU metadata.
planId	string	Plan identifier
planType	string	Specifies the primary deployment model and hosting architecture for the marketplace product. Currently supported values are: None - Unspecified product type, typically used for products without a defined deployment model DevService - Development-focused services and tools for software creation workflows ManagedApplication - Azure Managed Applications that deploy and manage resources in customer subscriptions VirtualMachine - Pre-configured virtual machine images deployable to Azure compute infrastructure AzureApplication - Native Azure applications leveraging platform services and APIs Container - Containerized applications deployed through Azure Container Instances or similar services SaaS - Software as a Service solutions hosted and managed by the publisher SolutionTemplate - Azure Resource Manager templates that provision multiple Azure resources IotEdgeModules - Modules designed for deployment to Azure IoT Edge runtime environments ManagedServices - Fully managed services where the publisher handles infrastructure and operations ContainerApps - Applications built for Azure Container Apps serverless container platform VisualStudioExtension - Extensions that integrate with Visual Studio IDE functionality DynamicsOps - Microsoft Dynamics 365 Finance and Operations applications and extensions DynamicsCE - Microsoft Dynamics 365 Customer Engagement applications and customizations DynamicsBC - Microsoft Dynamics 365 Business Central applications and add-ons PowerBI - Microsoft Power BI reports, dashboards, and data visualization components ConsultingServices - Professional services offerings including implementation and advisory services CosellOnly - Products available exclusively through Microsoft co-sell partner programs CoreVirtualMachine - Core virtual machine offerings with baseline Azure compute capabilities PowerBIVisuals - Custom visualizations for Microsoft Power BI reporting platform Office365 - Microsoft 365 and Office 365 applications, add-ins, and integrations AADApps - Azure Active Directory integrated applications supporting organizational identity AzureServices - Native Azure platform services and resource providers AppService - Web applications hosted on Azure App Service platform LogAnalytics - Azure Monitor Log Analytics solutions and workspace configurations MicrosoftProduct - First-party Microsoft products available through marketplace channels
pricingTypes	string[]	Indicates the billing models and cost structures available for the plan. Free - No charge for plan usage, typically for community editions or basic service tiers FreeTrial - Time-limited free access period before transitioning to paid billing model Byol - Bring Your Own License model where customers provide existing software licenses Payg - Pay As You Go consumption-based billing calculated on actual resource usage Ri - Reserved Instance billing with upfront commitment for discounted long-term pricing
skuId	string	The SKU id
stackType	string	Stack type : Classic, Gen1, Gen2
summary	string	The plan summary text
uniquePlanId	string	Unique plan identifier which is prefixed by combining uniqueProductId and PlanId with no separator in between
vmArchitectureType	string	Specifies the virtual machine processor architecture and generation. Applies exclusively to Virtual Machine product types. X64Gen1 - x64 processor architecture with Generation 1 virtual machine firmware and BIOS support X64Gen2 - x64 processor architecture with Generation 2 virtual machine firmware and UEFI support Arm64 - ARM 64-bit processor architecture optimized for energy efficiency and cloud-native workloads
vmSecuritytypes	string[]	Defines the security enhancement level for virtual machine deployments. Applies exclusively to Virtual Machine product types. None - Standard virtual machine security without additional protection features Trusted - Trusted Launch security with secure boot and virtual Trusted Platform Module capabilities Confidential - Confidential computing with memory encryption and attestation for sensitive workloads

ProductSummary

Object

Returns a subset of Product attributes

Name	Type	Description
applicableProducts	string[]	Product categories the offer belongs to
attributes	Attribute[]	Set of products attributes
azureBenefit	string	Indicates whether product purchases count toward Azure consumption commitment benefits for enterprise customers. Eligible - Product costs apply to Azure consumption commitment benefit calculations and credits NotEligible - Product costs do not qualify for Azure consumption commitment benefit programs
badges	string[]	Displays certification and qualification badges earned by the product for marketplace visibility. PreferredSolution - Microsoft-recognized solution meeting specific quality and partnership criteria PowerBICertified - Certified compatibility and integration with Microsoft Power BI platform AdditionalPurchaseRequirement - Product requires additional purchases or subscriptions for full functionality
categoryIds	string[]	Array of product categories
cspLegalTermsUri	string	The legal terms of the product for the CSP
description	string	The product description text
displayName	string	Product display name
hasMarketplaceFootprint	boolean	Indication if product has a representation in the marketplace
hasRiPlans	boolean	Indication whether the product has plans with reservations
industryIds	string[]	List of industry IDs the item belongs to
lastModifiedDateTime	string	Latest update date of the product
locations	string[]	List of locations which are available on the SKUs
longSummary	string	Product long summary
operatingSystems	string[]	Operating system info for this product
plans	PlanSummary[]	Full set of plan/SKU attributes
popularity	number (double)	Popularity of the product
pricingTypes	string[]	Indicates the billing models and cost structures available for the plan. Free - No charge for plan usage, typically for community editions or basic service tiers FreeTrial - Time-limited free access period before transitioning to paid billing model Byol - Bring Your Own License model where customers provide existing software licenses Payg - Pay As You Go consumption-based billing calculated on actual resource usage Ri - Reserved Instance billing with upfront commitment for discounted long-term pricing
privacyPolicyUri	string	The privacy policy of the product
productFamily	string	Product Family
productId	string	The unique id of the product
productSubType	string	Product sub type
productType	string	Specifies the primary deployment model and hosting architecture for the marketplace product stored in the Marketplace Catalog. None - Unspecified product type, typically used for products without a defined deployment model ManagedApplication - Azure Managed Applications that deploy and manage resources in customer subscriptions VirtualMachine - Pre-configured virtual machine images deployable to Azure compute infrastructure AzureApplication - Native Azure applications leveraging platform services and APIs Container - Containerized applications deployed through Azure Container Instances or similar services SaaS - Software as a Service solutions hosted and managed by the publisher SolutionTemplate - Azure Resource Manager templates that provision multiple Azure resources IotEdgeModules - Modules designed for deployment to Azure IoT Edge runtime environments ManagedServices - Fully managed services where the publisher handles infrastructure and operations ContainerApps - Applications built for Azure Container Apps serverless container platform DynamicsOps - Microsoft Dynamics 365 Finance and Operations applications and extensions DynamicsCE - Microsoft Dynamics 365 Customer Engagement applications and customizations DynamicsBC - Microsoft Dynamics 365 Business Central applications and add-ons PowerBI - Microsoft Power BI reports, dashboards, and data visualization components ConsultingServices - Professional services offerings including implementation and advisory services CosellOnly - Products available exclusively through Microsoft co-sell partner programs CoreVirtualMachine - Core virtual machine offerings with baseline Azure compute capabilities PowerBIVisuals - Custom visualizations for Microsoft Power BI reporting platform Office365 - Microsoft 365 and Office 365 applications, add-ins, and integrations AADApps - Azure Active Directory integrated applications supporting organizational identity AzureServices - Native Azure platform services and resource providers AppService - Web applications hosted on Azure App Service platform LogAnalytics - Azure Monitor Log Analytics solutions and workspace configurations MicrosoftProduct - First-party Microsoft products available through marketplace channels
publisherDisplayName	string	Publisher display name
publisherId	string	Publisher id
publisherType	string	Identifies the publisher relationship to Microsoft for support and partnership classification. Microsoft - First-party Microsoft product with direct Microsoft support and development ThirdParty - Independent software vendor product with publisher-provided support and maintenance
publishingStage	string	Indicates the product availability status and customer access level within Azure Marketplace. Preview - Limited availability to selected customers for testing and early access evaluation Public - General availability to all Azure Marketplace customers for production deployment
ratingAverage	number (double)	Average rating for the offer
ratingBuckets	string[]	Categorizes products by customer rating thresholds for marketplace filtering and discovery. AboveOne - Products with customer ratings exceeding 1.0 stars based on marketplace reviews AboveTwo - Products with customer ratings exceeding 2.0 stars based on marketplace reviews AboveThree - Products with customer ratings exceeding 3.0 stars based on marketplace reviews AboveFour - Products with customer ratings exceeding 4.0 stars based on marketplace reviews
ratingCount	integer (int32)	Total number of ratings for the offer
service	string	The service name of the product, such as 'Virtual Machines'
serviceFamily	string	The service family of the product, such as 'Compute'
smallIconUri	string	URI to the small product icon
summary	string	Product summary
supportedProducts	string[]	Maps to the list of compatible products
uniqueProductId	string	Unique product identifier

ProductSummaryListResult

Object

The custom response of a list operation.

Name	Type	Description
nextLink	string	The link to the next page of items
value	ProductSummary[]	The items on this page