Note

Access to this page requires authorization. You can try signing in or .

Access to this page requires authorization. You can try .

List multiTenantOrganizationMembers

Namespace: microsoft.graph

List the tenants and their properties in the multitenant organization.

This API is available in the following national cloud deployments.

Global service	US Government L4	US Government L5 (DOD)	China operated by 21Vianet
✅	❌	❌	❌

Permissions

Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions only if your app requires it. For details about delegated and application permissions, see Permission types. To learn more about these permissions, see the permissions reference.

Permission type	Least privileged permissions	Higher privileged permissions
Delegated (work or school account)	MultiTenantOrganization.ReadBasic.All	MultiTenantOrganization.ReadWrite.All, MultiTenantOrganization.Read.All
Delegated (personal Microsoft account)	Not supported.	Not supported.
Application	MultiTenantOrganization.Read.All	MultiTenantOrganization.ReadWrite.All

The properties returned depend on the permission granted:

MultiTenantOrganization.ReadBasic.All (delegated): Returns only the displayName and tenantId properties. Only active tenants are returned.
MultiTenantOrganization.Read.All, MultiTenantOrganization.ReadWrite.All, or Directory.Read.All (delegated or application): Returns all properties for both active and pending tenants.

Important

For delegated access using work or school accounts, the signed-in user must be assigned a supported Microsoft Entra role or a custom role that grants the permissions required for this operation. This operation supports the following built-in roles, which provide only the least privilege necessary:

Security Reader
Global Reader

HTTP request

GET /tenantRelationships/multiTenantOrganization/tenants

Optional query parameters

This method supports the $select and $filter OData query parameters to help customize the response. For general information, see OData query parameters.

Request headers

Name	Description
Authorization	Bearer {token}. Required. Learn more about authentication and authorization.

Request body

Don't supply a request body for this method.

Response

If successful, this method returns a 200 OK response code and a collection of multiTenantOrganizationMember objects in the response body.

Examples

The following example lists the tenants and their properties in the multitenant organization.

Request

GET https://graph.microsoft.com/v1.0/tenantRelationships/multiTenantOrganization/tenants


// Code snippets are only available for the latest version. Current version is 5.x

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.TenantRelationships.MultiTenantOrganization.Tenants.GetAsync();

For details about how to add the SDK to your project and create an authProvider instance, see the SDK documentation.



// Code snippets are only available for the latest major version. Current major version is $v1.*

// Dependencies
import (
	 "context"
	 msgraphsdk "github.com/microsoftgraph/msgraph-sdk-go"
	 //other-imports
)


// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
tenants, err := graphClient.TenantRelationships().MultiTenantOrganization().Tenants().Get(context.Background(), nil)

For details about how to add the SDK to your project and create an authProvider instance, see the SDK documentation.


// Code snippets are only available for the latest version. Current version is 6.x

GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);

MultiTenantOrganizationMemberCollectionResponse result = graphClient.tenantRelationships().multiTenantOrganization().tenants().get();

For details about how to add the SDK to your project and create an authProvider instance, see the SDK documentation.


const options = {
	authProvider,
};

const client = Client.init(options);

let tenants = await client.api('/tenantRelationships/multiTenantOrganization/tenants')
	.get();

For details about how to add the SDK to your project and create an authProvider instance, see the SDK documentation.


<?php
use Microsoft\Graph\GraphServiceClient;


$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);


$result = $graphServiceClient->tenantRelationships()->multiTenantOrganization()->tenants()->get()->wait();

For details about how to add the SDK to your project and create an authProvider instance, see the SDK documentation.


Import-Module Microsoft.Graph.Identity.SignIns

Get-MgTenantRelationshipMultiTenantOrganizationTenant

For details about how to add the SDK to your project and create an authProvider instance, see the SDK documentation.


# Code snippets are only available for the latest version. Current version is 1.x
from msgraph import GraphServiceClient
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python

result = await graph_client.tenant_relationships.multi_tenant_organization.tenants.get()

For details about how to add the SDK to your project and create an authProvider instance, see the SDK documentation.

Response

HTTP/1.1 200 OK
Content-Type: application/json

{
 "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#tenantRelationships/multiTenantOrganization/tenants",
 "value": [
 {
 "tenantId": "1fd6544e-e994-4de2-9f1b-787b51c7d325",
 "displayName": "Contoso",
 "addedDateTime": "2023-05-26T22:05:23Z",
 "joinedDateTime": null,
 "addedByTenantId": "1fd6544e-e994-4de2-9f1b-787b51c7d325",
 "role": "owner",
 "state": "active",
 "transitionDetails": null
 },
 {
 "tenantId": "4a12efe6-aa14-4d03-8dff-88fc89e2e2ad",
 "displayName": "Fabrikam",
 "addedDateTime": "2023-05-27T19:24:29Z",
 "joinedDateTime": null,
 "addedByTenantId": "1fd6544e-e994-4de2-9f1b-787b51c7d325",
 "role": "member",
 "state": "pending",
 "transitionDetails": null
 },
 {
 "tenantId": "5036a0a0-a7a4-4933-9086-5dd54535dd6e",
 "displayName": "Woodgrove Bank",
 "addedDateTime": "2023-05-27T20:41:56Z",
 "joinedDateTime": null,
 "addedByTenantId": "1fd6544e-e994-4de2-9f1b-787b51c7d325",
 "role": "member",
 "state": "pending",
 "transitionDetails": null
 }
 ]
}

Feedback

Was this page helpful?

Additional resources

Last updated on

URL: https://learn.microsoft.com/en-us/graph/api/multitenantorganization-list-tenants?view=graph-rest-1.0