Suger

Search Microsoft first-party products for an Azure co-sell

GET https://api.suger.cloud/org/{orgId}/cosell/partner/AZURE/microsoftSolutions/lookup/{searchTerm}

Search Microsoft's own products (Azure, Microsoft 365, Dynamics and the rest of the first-party catalog) by name and return the matches, each with the product identifier, name, publisher and price-list id. Use it to turn a product name a person used ("Azure Kubernetes Service") into the identifier an Azure co-sell referral needs. An Azure referral requires at least one entry under `details.requirements.solutions`, and the id in that entry comes from here — it is a Microsoft catalog identifier that cannot be guessed or composed. Search first, pick the match, then pass its id to CreateCosellReferral. This searches Microsoft's first-party catalog. For a solution published by another company, use AzureThirdPartySolutionLookup. Reads the catalog through this organization's Microsoft Partner Center connection and changes nothing; an organization with no Azure connection cannot use it. Returns at most 50 matches, so search a distinctive part of the name.

Parameters

NameInTypeRequiredDescription
orgId path string yes Organization ID
searchTerm path string yes Search term for Microsoft solution lookup

Responses

200 — Matching Microsoft first-party products. `value` is the match list — empty when nothing matched, which is a success, not an error. Take the id from an entry's `identifiers` and pass it to CreateCosellReferral under `details.requirements.solutions`.

Content-Type: application/json · Schema: MicrosoftSolutionLookupResponse

MicrosoftSolutionLookupResponse fields:

FieldTypeRequiredDescription
@odata.context string no
@odata.count integer no
value array<MicrosoftSolution> no

MicrosoftSolution fields:

FieldTypeRequiredDescription
identifiers array<MicrosoftSolutionIdentifier> no
incentives array<object> no
name string no
priceListId string no
publisherName string no
referralOrganizationId string no
type string no

MicrosoftSolutionIdentifier fields:

FieldTypeRequiredDescription
id string no
type string no

500 — Internal server error

Content-Type: application/json · Schema: ErrorResponse

ErrorResponse fields:

FieldTypeRequiredDescription
code ErrorCode no
info object no
message string no

View as Markdown · Interactive API reference

Spotted something wrong or out of date on this page? Tell us and we'll correct it.