title | description | ms.localizationpriority | doc_type | author | ms.subservice |
---|---|---|---|---|---|
List externalUserProfiles |
List all externalUserProfile objects. |
medium |
apiPageType |
jkdouglas |
entra-directory-management |
Namespace: microsoft.graph
[!INCLUDE beta-disclaimer]
Retrieve the properties of all externalUserProfiles
[!INCLUDE national-cloud-support]
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.
[!INCLUDE permissions-table]
[!INCLUDE rbac-externaluserprofiles-apis-read]
GET /directory/externalUserProfiles/{id}
You can use $filter
to only return specific external user profiles. The following properties can be used to $filter
:
- companyName
- supervisorId
For more information, see OData query parameters.
Name | Description |
---|---|
Authorization | Bearer {token}. Required. Learn more about authentication and authorization. |
Don't supply a request body for this method.
If successful, this method returns a 200 OK
response code and a JSON representation of the externalUserProfile in the response body.
The following example shows a request.
GET https://graph.microsoft.com/beta/directory/externalUserProfiles
[!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.
HTTP/1.1 200 OK
Content-type: application/json
{
"value": [
{
"id":"1e4ba82a-5f0c-423c-83e1-fc8ad69d8f02",
"isEnabled":true,
"createdDateTime":"2020-11-12T17:53:48Z",
"deletedDateTime":null,
"department":null,
"displayName":"Bob Henry",
"isDiscoverable":true,
"jobTitle":null,
"phoneNumber":"4257034568",
"address":{
"city":"Redmond",
"countryOrRegion":"USA",
"officeLocation":"B28",
"postalCode":"98052",
"state":"WA",
"street":"One Microsoft Way"
},
"createdBy":"67670e18-bf37-416c-b5c8-3bfdaad757cc",
"supervisorId":null,
"companyName":null
},
{
"id":"fffba82a-fffc-ff3c-83e1-fc8ff9dfff",
"isEnabled":true,
"createdDateTime":"2020-11-12T17:53:48Z",
"deletedDateTime":null,
"department":null,
"displayName":"Jack Hill",
"isDiscoverable":false,
"jobTitle":null,
"phoneNumber":"4257034788",
"address":{
"city":"Redmond",
"countryOrRegion":"USA",
"officeLocation":"B28",
"postalCode":"98052",
"state":"WA",
"street":"One Microsoft Way"
},
"createdBy":"67670e18-bf37-416c-b5c8-3bfdaad757cc",
"supervisorId":null,
"companyName":null
}
]
}
The following example shows a request.
GET https://graph.microsoft.com/beta/directory/externalUserProfiles$filter=isDiscoverable eq true
The following example shows the response.
HTTP/1.1 200 OK
Content-type: application/json
{
"value": [
{
"id":"1e4ba82a-5f0c-423c-83e1-fc8ad69d8f02",
"isEnabled":true,
"createdDateTime":"2020-11-12T17:53:48Z",
"deletedDateTime":null,
"department":null,
"displayName":"Bob Henry",
"isDiscoverable":true,
"jobTitle":null,
"phoneNumber":"4257034568",
"address":{
"city":"Redmond",
"countryOrRegion":"USA",
"officeLocation":"B28",
"postalCode":"98052",
"state":"WA",
"street":"One Microsoft Way"
},
"createdBy":"67670e18-bf37-416c-b5c8-3bfdaad757cc",
"supervisorId":null,
"companyName":null
}
]
}