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

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:

MicrosoftSolution fields:

MicrosoftSolutionIdentifier fields:

500 — Internal server error

Content-Type: application/json · Schema: ErrorResponse

ErrorResponse fields:

Example

Generated from this operation's schema. Values are placeholders — substitute your own ids, and set SUGER_TOKEN to a bearer token from the OAuth client-credentials exchange.

Request

curl -X GET 'https://api.suger.cloud/org/{orgId}/cosell/partner/AZURE/microsoftSolutions/lookup/{searchTerm}' \
  -H 'Authorization: Bearer $SUGER_TOKEN'

Response — 200

{
  "@odata.context": "string",
  "@odata.count": 1,
  "value": [
    {
      "identifiers": [
        {
          "id": "01H0000000000000000000",
          "type": "string"
        }
      ],
      "incentives": [],
      "name": "Acme Corp",
      "priceListId": "01H0000000000000000000",
      "publisherName": "Acme Corp",
      "referralOrganizationId": "01H0000000000000000000",
      "type": "string"
    }
  ]
}

Error — 500

{
  "code": "InternalServerError",
  "message": "string"
}

View as Markdown · Interactive API reference