ESC
Type to search...
↑↓ Navigate ↵ Open ESC Close

People.Read

Export JSON
Export CSV
Copy URL
Print
Delegated Read User Scope

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

In short

People.Read is a delegated permission in the Microsoft Graph API, grouped under the People category. Allows the app to read a ranked list of relevant people of the signed-in user. The list includes local contacts, contacts from social networking, your organization's directory, and people from recent communications (such as email and Skype). It grants read-only access to resources. Users can consent to this permission during sign-in.

Permission data: October 3, 2026 at 3:19 AM UTC
Delegated Access App-Only Access

Permission Details

Delegated Permission User consent allowed

Read users' relevant people lists

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

User sees: Allows the app to read a list of people in the order that's most relevant to you. This includes your local contacts, your contacts from social networking, people listed in your organization's directory, and people from recent communications.
Permission ID: ba47897c-39ec-4d83-8086-ee8256fa737d

Properties

Microsoft Graph v1.0 mapped-docs

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

Property Type Description
birthday StringNullable The person's birthday.
companyName StringNullable The name of the person's company.
department StringNullable The person's department.
displayName StringNullable The person's display name.
givenName StringNullable The person's given name.
id String The person's unique identifier. Read-only.
imAddress StringNullable The instant message voice over IP (VOIP) session initiation protocol (SIP) address for the user. Read-only.
isFavorite BooleanNullable True if the user has flagged this person as a favorite.
jobTitle StringNullable The person's job title.
officeLocation StringNullable The location of the person's office.
personNotes StringNullable 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 StringNullable 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 Delegated permissions and search for People.Read

4

Grant Admin Consent

Users can consent to this permission during sign-in.

Frequently asked questions

What is the People.Read Microsoft Graph permission?

People.Read is a delegated permission in the Microsoft Graph API, grouped under the People category. Allows the app to read a ranked list of relevant people of the signed-in user. The list includes local contacts, contacts from social networking, your organization's directory, and people from recent communications (such as email and Skype). It grants read-only access to resources. Users can consent to this permission during sign-in. It is mapped to the Microsoft Graph person resource type. 4 documented Microsoft Graph REST methods require it. 2 Microsoft Graph PowerShell commands are documented for it.

Is People.Read an application or a delegated permission?

People.Read is a delegated permission only. It grants access on behalf of a signed-in user and cannot be used for app-only access.

Does People.Read require admin consent?

Users can consent to this permission during sign-in.

What is the permission ID (GUID) for People.Read?

For People.Read, the delegated (OAuth2 scope) ID is ba47897c-39ec-4d83-8086-ee8256fa737d. These are the real Microsoft Graph identifiers and can be used directly in an app registration manifest.