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

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

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

Gets a list of the registration assignments.

## Path parameters

- `scope` string, required

## Query parameters

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

## Response `200`

OK - Returns a list of the registration assignments.

- RegistrationAssignmentList — The list of registration assignments.
  - `value` RegistrationAssignment[] — The list of registration assignments.
    - `properties` RegistrationAssignmentProperties — The properties of the registration assignment.
      - `registrationDefinitionId` string, required — The fully qualified path of the registration definition.
      - `provisioningState` 'NotSpecified' | 'Accepted' | 'Running' | 'Ready' | 'Creating' | 'Created' | 'Deleting' | 'Deleted' | 'Canceled' | 'Failed' | 'Succeeded' | 'Updating' — The current provisioning state of the registration assignment.
      - `registrationDefinition` object — The registration definition associated with the registration assignment.
        - `properties` object — The properties of the registration definition associated with the registration assignment.
          - `description` string — The description of the registration definition.
          - `authorizations` Authorization[] — 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.
              - …
          - `registrationDefinitionName` string — The name of the registration definition.
          - `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.
          - `managedByTenantId` string — The identifier of the managedBy 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
    - `id` string — The fully qualified path of the registration assignment.
    - `type` string — The type of the Azure resource (Microsoft.ManagedServices/registrationAssignments).
    - `name` string — The name of the registration assignment.
    - `systemData` SystemData — unresolved $ref
  - `nextLink` string — The link to the next page of registration assignments.

## 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/registrationAssignments/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)