title | description | ms.localizationpriority | author | ms.reviewer | ms.subservice | doc_type |
---|---|---|---|---|---|---|
List organizations |
Retrieve a list of organization objects. |
medium |
suawat |
alvarorahul, iamut |
entra-directory-management |
apiPageType |
Namespace: microsoft.graph
Retrieve a list of organization objects. There's only one organization object in the collection.
[!INCLUDE national-cloud-support]
One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.
Permission type | Permissions (from least to most privileged) |
---|---|
Delegated (work or school account) | User.Read, Organization.Read.All, Directory.Read.All, Organization.ReadWrite.All, Directory.ReadWrite.All |
Delegated (personal Microsoft account) | Not supported. |
Application | Organization.Read.All, Directory.Read.All, Organization.ReadWrite.All, Directory.ReadWrite.All |
[!INCLUDE rbac-organization-apis-read]
GET /organization
This method supports the $select
OData query parameter to help customize the response.
Name | Type | Description |
---|---|---|
Authorization | string | Bearer {token}. Required. |
Don't supply a request body for this method.
If successful, this method returns a 200 OK
response code and collection of organization objects in the response body. Only one object is returned in the collection.
The following example shows a request.
GET https://graph.microsoft.com/v1.0/organization
[!INCLUDE sample-code] [!INCLUDE sdk-documentation]
[!INCLUDE sample-code] [!INCLUDE sdk-documentation]
[!INCLUDE sample-code] [!INCLUDE sdk-documentation]
[!INCLUDE sample-code] [!INCLUDE sdk-documentation]
[!INCLUDE sample-code] [!INCLUDE sdk-documentation]
[!INCLUDE sample-code] [!INCLUDE sdk-documentation]
[!INCLUDE sample-code] [!INCLUDE sdk-documentation]
[!INCLUDE sample-code] [!INCLUDE sdk-documentation]
The following example shows the response.
Note: The response object shown here might be shortened for readability.
HTTP/1.1 200 OK
Content-type: application/json
{
"@odata.context": "https://graph.microsoft.com/v1.0/$metadata#organization",
"value": [
{
"id": "84841066-274d-4ec0-a5c1-276be684bdd3",
"deletedDateTime": null,
"businessPhones": [
"425-555-0100"
],
"city": null,
"country": null,
"countryLetterCode": "NL",
"createdDateTime": "2021-08-02T10:30:06Z",
"defaultUsageLocation": "String",
"displayName": "Contoso",
"isMultipleDataLocationsForServicesEnabled": null,
"marketingNotificationEmails": [],
"onPremisesLastSyncDateTime": null,
"onPremisesSyncEnabled": null,
"partnerTenantType": "ResellerPartnerDelegatedAdmin",
"postalCode": null,
"preferredLanguage": "en",
"securityComplianceNotificationMails": [],
"securityComplianceNotificationPhones": [],
"state": null,
"street": null,
"technicalNotificationMails": [
"admin@contoso.com"
],
"tenantType": "AAD",
"directorySizeQuota": {
"used": 698,
"total": 50000
},
"assignedPlans": [
{
"assignedDateTime": "2022-04-03T02:46:42Z",
"capabilityStatus": "Deleted",
"service": "Adallom",
"servicePlanId": "932ad362-64a8-4783-9106-97849a1a30b9"
},
{
"assignedDateTime": "2022-04-03T02:46:42Z",
"capabilityStatus": "Deleted",
"service": "MultiFactorService",
"servicePlanId": "8a256a2b-b617-496d-b51b-e76466e88db0"
},
{
"assignedDateTime": "2021-08-02T10:36:57Z",
"capabilityStatus": "Enabled",
"service": "exchange",
"servicePlanId": "113feb6c-3fe4-4440-bddc-54d774bf0318"
},
{
"assignedDateTime": "2021-08-02T10:36:02Z",
"capabilityStatus": "Deleted",
"service": "SCO",
"servicePlanId": "882e1d05-acd1-4ccb-8708-6ee03664b117"
}
],
"privacyProfile": {
"contactEmail": "",
"statementUrl": ""
},
"provisionedPlans": [
{
"capabilityStatus": "Deleted",
"provisioningStatus": "Success",
"service": "Adallom"
},
{
"capabilityStatus": "Enabled",
"provisioningStatus": "Success",
"service": "exchange"
}
],
"verifiedDomains": [
{
"capabilities": "Email, OfficeCommunicationsOnline",
"isDefault": true,
"isInitial": true,
"name": "contoso.com",
"type": "Managed"
}
]
}
]
}