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
| Name | In | Type | Required | Description |
|---|---|---|---|---|
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:
| Field | Type | Required | Description |
|---|---|---|---|
@odata.context | string | no | |
@odata.count | integer | no | |
value | array<MicrosoftSolution> | no |
MicrosoftSolution fields:
| Field | Type | Required | Description |
|---|---|---|---|
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:
| Field | Type | Required | Description |
|---|---|---|---|
id | string | no | |
type | string | no |
500 — Internal server error
Content-Type: application/json · Schema: ErrorResponse
ErrorResponse fields:
| Field | Type | Required | Description |
|---|---|---|---|
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.