Microsoft Marketplace Catalog Browse API (preview:2023-05-01)

2025/06/04 • 3 updated methods

Products_Get (updated)
Description :  Get a single commercial Marketplace public product.
Reference :  Link ¶

⚶ Changes

{
  "#id": "Products_Get",
  "Summary": {
    "new": "Get a single commercial Marketplace public product.",
    "old": "Single Public Product API provides an unauthenticated endpoint for consuming product attributes of a single commercial 3rd party Marketplace public product or 1st party Azure product. Each API request must include an API key allocated to you. Send an email to MKPL_Platform_API_DL@microsoft.com including the following details to get the API Key:\n- Customer name\n- Service/Product name\n- AD Registered App ID (if available)\n- Focal point email\n- Use case/scenario\n- Expected traffic volume, including peak requests per second (daily)"
  }
}

⚼ Request

GET:  /products/{id}
{
id: string ,
market: string ,
api-version: string ,
language: string ,
locations: array ,
includeStopSoldPlans: boolean ,
hideKeys: array ,
excludeSkuDetails: boolean ,
includeFutureAvailabilities: boolean ,
skuId: string ,
x-ms-pricing-audience: string ,
X-API-Key: string ,
}

⚐ Response (200)

{
displayName: string ,
popularity: number ,
categoryIds:
[
string ,
]
,
industryIds:
[
string ,
]
,
publisherId: string ,
azureBenefit: string ,
badges:
[
string ,
]
,
publisherType: string ,
publishingStage: string ,
uniqueProductId: string ,
productType: string ,
productSubType: string ,
productFamily: string ,
operatingSystems:
[
string ,
]
,
pricingTypes:
[
string ,
]
,
publisherDisplayName: string ,
longSummary: string ,
summary: string ,
linkedAddInsTypes: object ,
smallIconUri: string ,
description: string ,
ratingBuckets:
[
string ,
]
,
ratingAverage: number ,
ratingCount: integer ,
startingPrice: string ,
plans:
[
{
planId: string ,
uniquePlanId: string ,
displayName: string ,
vmArchitectureType: string ,
cspState: string ,
metadata: string ,
altStackReference: string ,
stackType: string ,
altArchitectureReference: string ,
categoryIds:
[
string ,
]
,
hasProtectedArtifacts: boolean ,
pricingTypes:
[
string ,
]
,
vmSecuritytypes:
[
string ,
]
,
summary: string ,
description: string ,
skuId: string ,
planType: string ,
displayRank: string ,
isPrivate: boolean ,
id: string ,
availabilities:
[
{
id: string ,
actions:
[
string ,
]
,
meter: string ,
pricingAudience: string ,
terms:
[
{
termDescriptionParameters:
[
{
parameter: string ,
value: string ,
}
,
]
,
termId: string ,
termUnit: string ,
prorationPolicy: string ,
termDescription: string ,
price: string ,
renewTermId: string ,
renewTermUnits: string ,
billingPlan: string ,
renewToTermBillingPlan: string ,
isAutorenewable: boolean ,
}
,
]
,
hasFreeTrials: boolean ,
consumptionUnitType: string ,
displayRank: integer ,
}
,
]
,
uiDefinitionUri: string ,
artifacts:
[
{
name: string ,
uri: string ,
artifactType: string ,
}
,
]
,
version: string ,
isHidden: boolean ,
isStopSell: boolean ,
stopSellInfo: string ,
minQuantity: integer ,
maxQuantity: integer ,
isQuantifiable: boolean ,
billingComponents:
[
{
billingTag: string ,
customMeterIds: object ,
}
,
]
,
purchaseDurationDiscounts:
[
{
duration: string ,
discountPercentage: number ,
}
,
]
,
isHiddenPrivateOffer: boolean ,
certifications:
[
{
id: string ,
displayName: string ,
uri: string ,
}
,
]
,
customerInstruction: string ,
planLabels:
[
string ,
]
,
skuType: string ,
skuTitle: string ,
location: string ,
armRegionName: string ,
cloud: string ,
locationType: string ,
region: string ,
skuGroupId: string ,
zone: string ,
feature: string ,
serviceType: string ,
skuAttributes:
[
{
key: string ,
value: string ,
}
,
]
,
skuProperties: string ,
offeringProperties:
[
{
productCode: string ,
termId: string ,
meterType: string ,
billingMeterId: string ,
offeringId: string ,
type: string ,
}
,
]
,
}
,
]
,
supportedProducts:
[
string ,
]
,
applicableProducts:
[
string ,
]
,
lastModifiedDateTime: string ,
locations:
[
string ,
]
,
serviceFamily: string ,
service: string ,
productId: string ,
hasMarketplaceFootprint: boolean ,
attributes:
[
{
key: string ,
value: string ,
}
,
]
,
language: string ,
hasStandardContractAmendments: boolean ,
offerId: string ,
standardContractAmendmentsRevisionId: string ,
universalAmendmentUrl: string ,
isPrivate: boolean ,
isStopSell: boolean ,
stopSellInfo: string ,
marketingMaterial: string ,
legalTermsUri: string ,
cspLegalTermsUri: string ,
legalTermsType: string ,
privacyPolicyUri: string ,
supportUri: string ,
uiDefinitionUri: string ,
screenshotUris:
[
string ,
]
,
links:
[
{
id: string ,
displayName: string ,
uri: string ,
}
,
]
,
linkedAddIns:
[
string ,
]
,
mediumIconUri: string ,
largeIconUri: string ,
wideIconUri: string ,
images:
[
{
context: string ,
items:
[
{
id: string ,
uri: string ,
type: string ,
}
,
]
,
}
,
]
,
artifacts:
[
{
name: string ,
uri: string ,
artifactType: string ,
}
,
]
,
videos:
[
{
caption: string ,
uri: string ,
videoPurpose: string ,
previewImage: string ,
}
,
]
,
additionalProductProperties: object ,
pricingDetailsUri: string ,
isReseller: boolean ,
productOwnershipSellingMotion: string ,
disableSendEmailOnPurchase: boolean ,
isCoreVm: boolean ,
}

⚐ Response (default)

{
$headers:
{
x-ms-error-code: string ,
}
,
$schema:
{
error:
{
code: string ,
message: string ,
}
,
}
,
}
Products_List (updated)
Description :  Get a list of commercial public products.
Reference :  Link ¶

⚶ Changes

{
  "#id": "Products_List",
  "Summary": {
    "new": "Get a list of commercial public products.",
    "old": "Public Products API provides an unauthenticated endpoint for consuming commercial 3rd party Marketplace public products and 1st party Azure products. In addition, it enables Odata filtering on selected product properties.  Each API request must include an API key allocated to you (see X-API-Key description). Send an email to MKPL_Platform_API_DL@microsoft.com including the following details to get the API Key:\n- Customer name\n- Service/Product name\n- AD Registered App ID (if available)\n- Focal point email\n- Use case/scenario\n- Expected traffic volume, including peak requests per second (daily)"
  }
}

⚼ Request

GET:  /products
{
api-version: string ,
storefront: string ,
language: string ,
locations: array ,
market: string ,
hideKeys: array ,
select: array ,
filter: string ,
expand: array ,
orderby: string ,
X-API-Key: string ,
}

⚐ Response (200)

{
items:
[
{
displayName: string ,
popularity: number ,
categoryIds:
[
string ,
]
,
industryIds:
[
string ,
]
,
publisherId: string ,
azureBenefit: string ,
badges:
[
string ,
]
,
publisherType: string ,
publishingStage: string ,
uniqueProductId: string ,
productType: string ,
productSubType: string ,
productFamily: string ,
operatingSystems:
[
string ,
]
,
pricingTypes:
[
string ,
]
,
publisherDisplayName: string ,
longSummary: string ,
summary: string ,
linkedAddInsTypes: object ,
smallIconUri: string ,
description: string ,
cspLegalTermsUri: string ,
privacyPolicyUri: string ,
ratingBuckets:
[
string ,
]
,
ratingAverage: number ,
ratingCount: integer ,
startingPrice: string ,
plans:
[
{
planId: string ,
uniquePlanId: string ,
displayName: string ,
vmArchitectureType: string ,
cspState: string ,
metadata: string ,
altStackReference: string ,
stackType: string ,
altArchitectureReference: string ,
categoryIds:
[
string ,
]
,
hasProtectedArtifacts: boolean ,
pricingTypes:
[
string ,
]
,
vmSecuritytypes:
[
string ,
]
,
summary: string ,
description: string ,
skuId: string ,
planType: string ,
displayRank: string ,
isPrivate: boolean ,
hasRI: boolean ,
}
,
]
,
supportedProducts:
[
string ,
]
,
applicableProducts:
[
string ,
]
,
lastModifiedDateTime: string ,
locations:
[
string ,
]
,
serviceFamily: string ,
service: string ,
productId: string ,
hasRIPlans: boolean ,
hasMarketplaceFootprint: boolean ,
attributes:
[
{
key: string ,
value: string ,
}
,
]
,
}
,
]
,
nextPageLink: string ,
}

⚐ Response (default)

{
$headers:
{
x-ms-error-code: string ,
}
,
$schema:
{
error:
{
code: string ,
message: string ,
}
,
}
,
}
Skus_List (updated)
Description :  List commercial skus.
Reference :  Link ¶

⚶ Changes

{
  "#id": "Skus_List",
  "Summary": {
    "new": "List commercial skus.",
    "old": "Public Skus API provides an unauthenticated endpoint for consuming commercial 3rd party Marketplace public skus and 1st party Azure skus. In addition, it enables Odata filtering on selected sku properties or attributes. Each API request must include an API key allocated to you (see X-API-Key description). Send an email to MKPL_Platform_API_DL@microsoft.com including the following details to get the API Key:\n- Customer name\n- Service/Product name\n- AD Registered App ID (if available)\n- Focal point email\n- Use case/scenario\n- Expected traffic volume, including peak requests per second (daily)"
  }
}

⚼ Request

GET:  /skus
{
api-version: string ,
serviceFamily: string ,
service: string ,
language: string ,
locations: array ,
market: string ,
select: array ,
filter: string ,
orderby: string ,
X-API-Key: string ,
}

⚐ Response (200)

{
items:
[
{
productId: string ,
productDisplayName: string ,
productDescription: string ,
serviceFamily: string ,
service: string ,
publisherId: string ,
publisherType: string ,
productType: string ,
productSubType: string ,
summary: string ,
productAttributes:
[
{
key: string ,
value: string ,
}
,
]
,
skuName: string ,
skuId: string ,
skuType: string ,
language: string ,
skuDescription: string ,
skuTitle: string ,
lastModifiedDateTime: string ,
location: string ,
armRegionName: string ,
cloud: string ,
locationType: string ,
region: string ,
skuGroupId: string ,
zone: string ,
feature: string ,
serviceType: string ,
minQuantity: integer ,
maxQuantity: integer ,
cspState: string ,
hasRI: boolean ,
skuAttributes:
[
{
key: string ,
value: string ,
}
,
]
,
skuProperties: string ,
offeringProperties:
[
{
productCode: string ,
termId: string ,
meterType: string ,
billingMeterId: string ,
offeringId: string ,
type: string ,
}
,
]
,
}
,
]
,
nextPageLink: string ,
}

⚐ Response (default)

{
$headers:
{
x-ms-error-code: string ,
}
,
$schema:
{
error:
{
code: string ,
message: string ,
}
,
}
,
}