microsoft.graph.subscribedSku

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/azure-ad/json-schema/azure-ad-microsoft-graph-subscribed-sku-schema.json",
  "title": "microsoft.graph.subscribedSku",
  "x-generated": "2026-11-05",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/azure-ad-subscribedskus-subscribedsku-api-openapi.yml#/components/schemas/microsoft.graph.subscribedSku",
  "allOf": [
    {
      "$ref": "#/$defs/microsoft.graph.entity"
    },
    {
      "title": "subscribedSku",
      "type": "object",
      "properties": {
        "accountId": {
          "type": [
            "string",
            "null"
          ],
          "description": "The unique ID of the account this SKU belongs to."
        },
        "accountName": {
          "type": [
            "string",
            "null"
          ],
          "description": "The name of the account this SKU belongs to."
        },
        "appliesTo": {
          "type": [
            "string",
            "null"
          ],
          "description": "The target class for this SKU. Only SKUs with target class User are assignable. The possible values are: User, Company."
        },
        "capabilityStatus": {
          "type": [
            "string",
            "null"
          ],
          "description": "Enabled indicates that the prepaidUnits property has at least one unit that is enabled. LockedOut indicates that the customer canceled their subscription. The possible values are: Enabled, Warning, Suspended, Deleted, LockedOut."
        },
        "consumedUnits": {
          "maximum": 2147483647,
          "minimum": -2147483648,
          "type": [
            "number",
            "null"
          ],
          "description": "The number of licenses that have been assigned.",
          "format": "int32"
        },
        "prepaidUnits": {
          "$ref": "#/$defs/microsoft.graph.licenseUnitsDetail"
        },
        "servicePlans": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/microsoft.graph.servicePlanInfo"
          },
          "description": "Information about the service plans that are available with the SKU. Not nullable."
        },
        "skuId": {
          "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
          "type": [
            "string",
            "null"
          ],
          "description": "The unique identifier (GUID) for the service SKU.",
          "format": "uuid"
        },
        "skuPartNumber": {
          "type": [
            "string",
            "null"
          ],
          "description": "The SKU part number; for example: AAD_PREMIUM or RMSBASIC. To get a list of commercial subscriptions that an organization has acquired, see List subscribedSkus."
        },
        "subscriptionIds": {
          "type": "array",
          "items": {
            "type": [
              "string",
              "null"
            ]
          },
          "description": "A list of all subscription IDs associated with this SKU."
        }
      },
      "additionalProperties": {
        "type": "object"
      }
    }
  ],
  "$defs": {
    "microsoft.graph.entity": {
      "title": "entity",
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "description": "The unique identifier for an entity. Read-only."
        }
      },
      "additionalProperties": {
        "type": "object"
      }
    },
    "microsoft.graph.licenseUnitsDetail": {
      "title": "licenseUnitsDetail",
      "type": "object",
      "properties": {
        "enabled": {
          "maximum": 2147483647,
          "minimum": -2147483648,
          "type": [
            "number",
            "null"
          ],
          "description": "The number of units that are enabled for the active subscription of the service SKU.",
          "format": "int32"
        },
        "lockedOut": {
          "maximum": 2147483647,
          "minimum": -2147483648,
          "type": [
            "number",
            "null"
          ],
          "description": "The number of units that are locked out because the customer canceled their subscription of the service SKU.",
          "format": "int32"
        },
        "suspended": {
          "maximum": 2147483647,
          "minimum": -2147483648,
          "type": [
            "number",
            "null"
          ],
          "description": "The number of units that are suspended because the subscription of the service SKU has been canceled. The units can't be assigned but can still be reactivated before they're deleted.",
          "format": "int32"
        },
        "warning": {
          "maximum": 2147483647,
          "minimum": -2147483648,
          "type": [
            "number",
            "null"
          ],
          "description": "The number of units that are in warning status. When the subscription of the service SKU has expired, the customer has a grace period to renew their subscription before it's canceled (moved to a suspended state).",
          "format": "int32"
        }
      },
      "additionalProperties": {
        "type": "object"
      }
    },
    "microsoft.graph.servicePlanInfo": {
      "title": "servicePlanInfo",
      "type": "object",
      "properties": {
        "appliesTo": {
          "type": [
            "string",
            "null"
          ],
          "description": "The object the service plan can be assigned to. The possible values are:User - service plan can be assigned to individual users.Company - service plan can be assigned to the entire tenant."
        },
        "provisioningStatus": {
          "type": [
            "string",
            "null"
          ],
          "description": "The provisioning status of the service plan. The possible values are:Success - Service is fully provisioned.Disabled - Service is disabled.Error - The service plan isn't provisioned and is in an error state.PendingInput - The service isn't provisioned and is awaiting service confirmation.PendingActivation - The service is provisioned but requires explicit activation by an administrator (for example, Intune_O365 service plan)PendingProvisioning - Microsoft has added a new service to the product SKU and it isn't activated in the tenant."
        },
        "servicePlanId": {
          "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
          "type": [
            "string",
            "null"
          ],
          "description": "The unique identifier of the service plan.",
          "format": "uuid"
        },
        "servicePlanName": {
          "type": [
            "string",
            "null"
          ],
          "description": "The name of the service plan."
        }
      },
      "additionalProperties": {
        "type": "object"
      }
    }
  }
}