Organization Users

The /Organizations/{organizationId}/Users resource collection represents organization users.

Get Organization Users

Returns a collection of organization users.

SecurityBearer

Request

path Parameters

organizationId

required

string <uuid>

Specifies the identification number of the Microsoft 365 organization. For more information on how to get this parameter, see Get Organizations.

query Parameters

limit	integer <int32> Limits the maximum number of items that the server will return on a page. The maximum supported number of items per page is 10,000. The default value is 30.
offset	integer <int32> Excludes from a response page the first N items of a collection resource. The default value is 0.
setId	string <uuid> Specifies ID of a request sent earlier and stored in cache. Using the ID, you decrease the number of requests to the cloud.
userName	string Specifies an email address of the organization user.
displayName	string Specifies a display name of the organization user. To filter objects, you can use * and ? wildcard characters.
locationFilter	string Specifies an organization user location type. Note: Use this parameter for organizations of the Hybrid type. Enum: "Cloud" "OnPremises" "Hybrid" "CloudOrHybrid" "OnPremisesOrHybrid" "Any"
dataSource	string Defines the representation of the organization users that will be returned to the client. The following values are available: PreferLocal. For Microsoft organizations with modern app-only authentication, data is returned from either the organization cache database if organization objects are already synchronized to this source, or directly from the organization if synchronization is in progress. For Microsoft organizations with modern authentication and legacy protocols or with basic authentication, data is returned directly from the organization. Production. Data is returned directly from the organization. PreferLocalResynced. For Microsoft organizations with modern app-only authentication, synchronization of objects with the organization cache database is started and upon synchronization completes, data is returned from the organization cache database. For Microsoft organizations with modern authentication and legacy protocols or with basic authentication, data is returned directly from the organization. The default value is PreferLocal. Enum: "PreferLocal" "Production" "PreferLocalResynced"
detectedSkuType	string Specifies a type of the service SKU. Enum: "Other" "Education"

Responses

200

default

Operation failure response.

get/v8/Organizations/{organizationId}/Users

Request samples

curl
Python
JavaScript
C#
Go

Response samples

200
default

application/json

{"offset": 0,
"limit": 0,
"setId": "83e19bc1-5428-42b5-88ea-b28354e481f3",
"results": [{"id": "string",
"eTag": 0,
"onPremisesSid": "string",
"displayName": "string",
"name": "string",
"type": "User",
"locationType": "OnPremises",
"office": "string",
"assignedLicenses": [{"skuId": "00000000-0000-0000-0000-000000000000",
"skuPartNumber": "00000000-0000-0000-0000-000000000000",
"detectedSkuType": "Other"
}
],
"msid": "87dd99df-6b92-4088-9037-e179379ebcf2",
"_links": {"property1": {"href": "string"
},
"property2": {"href": "string"
}
}
}
],
"_links": {"property1": {"href": "string"
},
"property2": {"href": "string"
}
}
}

Get Organization User

Returns a resource representation of an organization user with the specified ID.

SecurityBearer

Request

path Parameters

organizationId required	string <uuid> Specifies the identification number of the Microsoft 365 organization. For more information on how to get this parameter, see Get Organizations.
userId required	string Specifies the identification number of the user. For more information on how to get this parameter, see Get Organization Users.

query Parameters

dataSource

string

Defines the representation of the organization users that will be returned to the client. The following values are available:

PreferLocal. For Microsoft organizations with modern app-only authentication, data is returned from either the organization cache database if organization objects are already synchronized to this source, or directly from the organization if synchronization is in progress. For Microsoft organizations with modern authentication and legacy protocols or with basic authentication, data is returned directly from the organization.
Production. Data is returned directly from the organization.
PreferLocalResynced. For Microsoft organizations with modern app-only authentication, synchronization of objects with the organization cache database is started and upon synchronization completes, data is returned from the organization cache database. For Microsoft organizations with modern authentication and legacy protocols or with basic authentication, data is returned directly from the organization.

The default value is PreferLocal.

Enum: "PreferLocal" "Production" "PreferLocalResynced"