--- title: "GET /providers/Microsoft.Marketplace/products" method: GET path: "/providers/Microsoft.Marketplace/products" tags: ["ProductList"] --- # GET /providers/Microsoft.Marketplace/products `GET /providers/Microsoft.Marketplace/products` ## Request - Base URL: `https://management.azure.com` - URL: `https://management.azure.com/providers/Microsoft.Marketplace/products` - Auth: OAuth 2 - Implicit: `https://login.microsoftonline.com/common/oauth2/authorize` - Scopes: `user_impersonation` Lists products for tenant. ## Query parameters - `market` string - `language` string - `excludePublicOffersAndPublicPlans` boolean - `$filter` string - `$select` string - `$expand` string - `$orderBy` string - `$search` string ## Parameters - `../../../../../../common-types/resource-management/v5/types.json#/components/parameters/ApiVersionParameter` (unresolved $ref) ## Response `200` Azure operation completed successfully. - ProductSummaryListResult: The custom response of a list operation. - `value` ProductSummary[], required: The items on this page - `displayName` string: Product display name - `popularity` number, double: Popularity of the product - `categoryIds` string[]: Array of product categories - `industryIds` string[]: List of industry IDs the item belongs to - `publisherId` string: Publisher id - `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 - `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 - `uniqueProductId` string, required: Unique product identifier - `productType` string, required: 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 - `productSubType` string: Product sub type - `productFamily` string: Product Family - `operatingSystems` string[]: Operating system info for this 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 - `ContactPublisher` - Pricing is not listed and the customer must contact the publisher to obtain pricing details - `Freemium` - Free base tier with paid upgrades, applies to Microsoft managed products - `RequestPrivateOffer` - Customer must request a private offer to obtain pricing, applies to Marketplace products - `PrivateOffer` - Indicates the plan is a promo plan tied to a private offer - `publisherDisplayName` string: Publisher display name - `longSummary` string: Product long summary - `summary` string: Product summary - `smallIconUri` string: URI to the small product icon - `description` string: The product description text - `cspLegalTermsUri` string: The legal terms of the product for the CSP - `privacyPolicyUri` string: The privacy policy of the product - `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 - `ratingAverage` number, double: Average rating for the offer - `ratingCount` integer: Total number of ratings for the offer - `supportedProducts` string[]: Maps to the list of compatible products - `applicableProducts` string[]: Product categories the offer belongs to - `lastModifiedDateTime` string: Latest update date of the product - `locations` string[]: List of locations which are available on the SKUs - `serviceFamily` string: The service family of the product, such as 'Compute' - `service` string: The service name of the product, such as 'Virtual Machines' - `productId` string: The unique id of the product - `hasRiPlans` boolean: Indication whether the product has plans with reservations - `hasMarketplaceFootprint` boolean: Indication if product has a representation in the marketplace - `attributes` Attribute[]: Set of products attributes - `key` string: The attribute key - `value` string: The attribute value - `offeringType` string: Offering type of product family Offers - `plans` PlanSummary[]: Full set of plan/SKU attributes - `planId` string: Plan identifier - `uniquePlanId` string: Unique plan identifier which is prefixed by combining uniqueProductId and PlanId with no separator in between - `displayName` string: Display name of the plan / sku - `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 - `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 - `metadata` PlanMetadata: Additional metadata - `generation` string: The VM image generation (applicable to Virtual Machine products only) - `altStackReference` string: Pointing to a planId which holds the alternative stack reference - `altStackReference` string: Alternative stack reference - `stackType` string: Stack type : Classic, Gen1, Gen2 - `altArchitectureReference` string: The alternative architecture reference - `categoryIds` string[]: Plan CategoryIds - `hasProtectedArtifacts` boolean: Set to true if plan has artifacts that are to be hidden for non authenticated users - `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 - `ContactPublisher` - Pricing is not listed and the customer must contact the publisher to obtain pricing details - `Freemium` - Free base tier with paid upgrades, applies to Microsoft managed products - `RequestPrivateOffer` - Customer must request a private offer to obtain pricing, applies to Marketplace products - `PrivateOffer` - Indicates the plan is a promo plan tied to a private offer - `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 - `summary` string: The plan summary text - `description` string: Plan / sku description - `skuId` string: The SKU id - `planType` string, required: 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 - `displayRank` string: The order the plan is displayed in the 'Plans' table - `isPrivate` boolean: Indication that the plan is accessible to restricted audience only - `hasRi` boolean: Indication whether the SKU supports reservations - `nextLink` string: The link to the next page of items ## Other responses - `default`: An unexpected error response. --- [API](https://skmtc.dev/azure/apis/microsoft-marketplace-management-service.md) - [All operations](https://skmtc.dev/azure/apis/microsoft-marketplace-management-service/llms.txt) - [OpenAPI document](https://skmtc.dev/azure/apis/microsoft-marketplace-management-service/revisions/be6ee070cdc0?raw)