People.Read.All | Graph Permissions

Permission Details

Application Permission

Read all users' relevant people lists

Allows the app to read any user's scored list of relevant people, without a signed-in user. The list can include local contacts, contacts from social networking, your organization's directory, and people from recent communications (such as email and Skype).

Permission ID: b528084d-ad10-4598-8b93-929746b4d7d6

Delegated Permission

Read all users' relevant people lists

Allows the app to read a scored list of relevant people of the signed-in user or other users in the signed-in user's organization. The list can include local contacts, contacts from social networking, your organization's directory, and people from recent communications (such as email and Skype).

Permission ID: b89f9189-71a5-4e70-b041-9887f0bc7e4a

Properties

Microsoft Graph v1.0 mapped-docs

Properties is shown from stable Microsoft Graph v1.0 metadata.

Property	Type	Description
`birthday`	`String`Nullable	The person's birthday.
`companyName`	`String`Nullable	The name of the person's company.
`department`	`String`Nullable	The person's department.
`displayName`	`String`Nullable	The person's display name.
`givenName`	`String`Nullable	The person's given name.
`id`	`String`	The person's unique identifier. Read-only.
`imAddress`	`String`Nullable	The instant message voice over IP (VOIP) session initiation protocol (SIP) address for the user. Read-only.
`isFavorite`	`Boolean`Nullable	True if the user has flagged this person as a favorite.
`jobTitle`	`String`Nullable	The person's job title.
`officeLocation`	`String`Nullable	The location of the person's office.
`personNotes`	`String`Nullable	Free-form notes that the user has taken about this person.
`personType`	`personType`	The type of person.
`phones`	`phone collection`	The person's phone numbers.
`postalAddresses`	`location collection`	The person's addresses.
`profession`	`String`Nullable	The person's profession.

Showing 15 of 20 properties.

JSON Representation

Microsoft Graph v1.0 mapped-docs

JSON representation is shown from stable Microsoft Graph v1.0 metadata.

JSON representation

{
  "birthday": "String",
  "companyName": "String",
  "department": "String",
  "displayName": "String",
  "scoredEmailAddresses": [
    {
      "@odata.type": "microsoft.graph.scoredEmailAddress"
    }
  ],
  "givenName": "String",
  "id": "String (identifier)",
  "imAddress": "String",
  "isFavorite": "Boolean",
  "jobTitle": "String",
  "officeLocation": "String",
  "personNotes": "String",
  "personType": {
    "@odata.type": "microsoft.graph.personType"
  },
  "phones": [
    {
      "@odata.type": "microsoft.graph.phone"
    }
  ],
  "postalAddresses": [
    {
      "@odata.type": "microsoft.graph.location"
    }
  ],
  "profession": "String",
  "surname": "String",
  "userPrincipalName": "String",
  "websites": [
    {
      "@odata.type": "microsoft.graph.website"
    }
  ],
  "yomiCompany": "String"
}

Relationships

Microsoft Graph v1.0 mapped

Relationships is shown from stable Microsoft Graph v1.0 metadata.

Relationship	Type	Description
`profilePhoto`	`profilePhoto`	Profile photo for the person.
`phones`	`phone collection`	The person's phone numbers.
`postalAddresses`	`location collection`	The person's addresses.
`scoredEmailAddresses`	`scoredEmailAddress collection`	The person's email addresses.
`websites`	`website collection`	The person's websites.
`emailAddresses`	`rankedEmailAddress collection`	The person's email addresses.
`sources`	`personDataSource collection`	The sources the user data comes from, for example Directory or Outlook Contacts.

Graph Methods

Delegated access App-only access

Exact Microsoft Learn match

Microsoft Graph v1.0 endpoints are mapped directly from refreshed Microsoft Learn permissions tables.

Methods
GET `/me/people`
GET `/users/{id \| userPrincipalName}/people`

Exact Microsoft Learn match

Microsoft Graph beta endpoints are mapped directly from refreshed Microsoft Learn permissions tables.

Methods
GET `/me/people`
GET `/users/{id \| userPrincipalName}/people`

Exact Microsoft Learn PowerShell match

Microsoft Graph PowerShell v1.0 commands are mapped directly from refreshed Microsoft Learn PowerShell snippets.

Commands
`Get-MgUserPerson` /me/people List people

Exact Microsoft Learn PowerShell match

Microsoft Graph PowerShell beta commands are mapped directly from refreshed Microsoft Learn PowerShell snippets.

Commands
`Get-MgBetaUserPerson` /me/people List people

Code Examples

C# / .NET SDK

List people

View official example on Microsoft Learn

// 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.Me.People.GetAsync();

JavaScript

List people

View official example on Microsoft Learn

const options = {
	authProvider,
};

const client = Client.init(options);

let people = await client.api('/me/people')
	.get();

PowerShell

List people

View official example on Microsoft Learn

Import-Module Microsoft.Graph.People
# A UPN can also be used as -UserId.
Get-MgUserPerson -UserId $userId

Python

List people

View official example on Microsoft Learn

# 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.me.people.get()

App Registration

1

Navigate to Azure Portal

Go to App registrations in Microsoft Entra admin center

2

Add API Permission

Select your app → API permissions → Add a permission → Microsoft Graph

3

Select Permission Type

Choose Application permissions or delegated permissions and search for People.Read.All

4

Grant Admin Consent

Application permissions always require admin consent.