Office 365 Developer: Using People API with Microsoft Graph v1.0

Microsoft Graph provides access to useful people data. You can use the person resource and the People API to aggregate information about a person from across mail, contacts, and social networks. The results are ordered by their relevance based on multiple communication and collaboration patterns and business relationships. The API lets you browse, sort, select, filter, or search for persons based on your criteria. Now the People API is available in Microsoft Graph v1.0.

To learn more about how to use the People API in v1.0, see our reference documentation and the article Get information about relevant people.

This API now requires one of two scopes: People.Read or People.Read.All.

  • People.Read will continue to be required for general People API calls, for example People.Read will require end user consent.
  • We are introducing People.Read.All; which will be required to retrieve the people most relevant to a specified user in the signed-in user’s organization ('{id}')/people) calls. People.Read.All will require admin consent.

So i went ahead, played with People API against my test Office 365 mailbox. I see the following:


GET V1.0'{b0386fe0-30d5-4e1d-b1ad-55bf082db9b8}')/people


     "@odata.context": "$metadata#users('%7Bb0386fe0-30d5-4e1d-b1ad-55bf082db9b8%7D')/people",
     "value": [
             "id": "b0386fe0-30d5-4e1d-b1ad-55bf082db9b8",
             "displayName": "Melissa Darrow",
             "givenName": "Melissa",
             "surname": "Darrow",
             "birthday": "",
             "personNotes": "",
             "isFavorite": false,
             "jobTitle": "Marketing Director",
             "companyName": null,
             "yomiCompany": "",
             "department": "Sales & Marketing",
             "officeLocation": "131/1105",
             "profession": "",
             "userPrincipalName": "",
             "imAddress": "",
             "scoredEmailAddresses": [
                     "address": "",
                     "relevanceScore": 1
             "phones": [
                     "type": "mobile",
                     "number": "+1 206 555 0110"
             "postalAddresses": [],
             "websites": [],
             "personType": {
                 "class": "Person",
                 "subclass": "OrganizationUser"

Still if you’re interested, you can go ahead and test the following as well:

Get a collection of relevant people


Request a subsequent page of people


Sort the response


Select the fields to return



Hope this helps Smile

Comments (2)
  1. Nanisha says:

    Sure, this article helps, thank you!!

    1. Deva [MSFT] says:

      I am glad that the article helped 🙂

Comments are closed.

Skip to main content