---
title: "GET /{scope}/providers/Microsoft.ManagedServices/registrationDefinitions"
method: GET
path: "/{scope}/providers/Microsoft.ManagedServices/registrationDefinitions"
tags: ["RegistrationDefinitions"]
---

# GET /{scope}/providers/Microsoft.ManagedServices/registrationDefinitions

`GET /{scope}/providers/Microsoft.ManagedServices/registrationDefinitions`

Gets a list of the registration definitions.

## Path parameters

- `scope` string, required

## Query parameters

- `api-version` string, required
- `$filter` string

## Response `200`

OK - Returns a list of the registration definitions.

- RegistrationDefinitionList — The list of registration definitions.
  - `value` RegistrationDefinition[] — The list of registration definitions.
    - `properties` RegistrationDefinitionProperties — The properties of a registration definition.
      - `description` string — The description of the registration definition.
      - `authorizations` Authorization[], required — The collection of authorization objects describing the access Azure Active Directory principals in the managedBy tenant will receive on the delegated resource in the managed tenant.
        - `principalId` string, required — The identifier of the Azure Active Directory principal.
        - `principalIdDisplayName` string — The display name of the Azure Active Directory principal.
        - `roleDefinitionId` string, required — The identifier of the Azure built-in role that defines the permissions that the Azure Active Directory principal will have on the projected scope.
        - `delegatedRoleDefinitionIds` string[] — The delegatedRoleDefinitionIds field is required when the roleDefinitionId refers to the User Access Administrator Role. It is the list of role definition ids which define all the permissions that the user in the authorization can assign to other principals.
      - `eligibleAuthorizations` EligibleAuthorization[] — The collection of eligible authorization objects describing the just-in-time access Azure Active Directory principals in the managedBy tenant will receive on the delegated resource in the managed tenant.
        - `principalId` string, required — The identifier of the Azure Active Directory principal.
        - `principalIdDisplayName` string — The display name of the Azure Active Directory principal.
        - `roleDefinitionId` string, required — The identifier of the Azure built-in role that defines the permissions that the Azure Active Directory principal will have on the projected scope.
        - `justInTimeAccessPolicy` JustInTimeAccessPolicy — Just-in-time access policy setting.
          - `multiFactorAuthProvider` 'Azure' | 'None', required — The multi-factor authorization provider to be used for just-in-time access requests.
          - `maximumActivationDuration` string, duration — The maximum access duration in ISO 8601 format for just-in-time access requests.
          - `managedByTenantApprovers` EligibleApprover[] — The list of managedByTenant approvers for the eligible authorization.
            - `principalId` string, required — The identifier of the Azure Active Directory principal.
            - `principalIdDisplayName` string — The display name of the Azure Active Directory principal.
      - `registrationDefinitionName` string — The name of the registration definition.
      - `managedByTenantId` string, required — The identifier of the managedBy tenant.
      - `provisioningState` 'NotSpecified' | 'Accepted' | 'Running' | 'Ready' | 'Creating' | 'Created' | 'Deleting' | 'Deleted' | 'Canceled' | 'Failed' | 'Succeeded' | 'Updating' — The current provisioning state of the registration definition.
      - `manageeTenantId` string — The identifier of the managed tenant.
      - `manageeTenantName` string — The name of the managed tenant.
      - `managedByTenantName` string — The name of the managedBy tenant.
    - `plan` Plan — The details for the Managed Services offer’s plan in Azure Marketplace.
      - `name` string, required — Azure Marketplace plan name.
      - `publisher` string, required — Azure Marketplace publisher ID.
      - `product` string, required — Azure Marketplace product code.
      - `version` string, required — Azure Marketplace plan's version.
    - `id` string — The fully qualified path of the registration definition.
    - `type` string — The type of the Azure resource (Microsoft.ManagedServices/registrationDefinitions).
    - `name` string — The name of the registration definition.
    - `systemData` SystemData — unresolved $ref
  - `nextLink` string — The link to the next page of registration definitions.

## Other responses

- `default` — The error response describing why the operation failed.

## Changes

- **2026-07-13** (2018-06-01-preview) `520e6fb7cca3` — 1 info
  - added the new optional `query` request parameter `$filter`

[Change history](https://skmtc.dev/azure/apis/managedservices-microsoft-managedservices-managedservices/changes/:scope/providers/Microsoft.ManagedServices/registrationDefinitions/get.md)

---

[API](https://skmtc.dev/azure/apis/managedservices-microsoft-managedservices-managedservices.md) · [All operations](https://skmtc.dev/azure/apis/managedservices-microsoft-managedservices-managedservices/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/azure/managedservices-microsoft-managedservices-managedservices/revisions/d59a7f8afee7/schema)