Use the Profile API in Microsoft Graph to retrieve information about yourself or another user
Namespace: microsoft.graph
Microsoft Graph applications can use the Profile API to retrieve the profile of the signed-in user or another user with a valid Microsoft Entra ID or Microsoft account. This information can be used in applications to help contextualizing another user, providing a richer experience for the user within the application or as a mechanism for storing extended information about the user that can also be used within Microsoft 365.
To call the People API in Microsoft Graph, your app needs the appropriate permissions:
- User.Read - Use to make general Profile API calls; for example,
https://graph.microsoft.com/beta/me/profile/. User.Read requires end user consent.
The requests in this section get the people most relevant to the signed-in user (/me). These requests require the User.Read permission to be present for the signed-in user.
GET https://graph.microsoft.com/beta/me/profile/
The following example shows the response. By default, each response returns 10 records. You can change this by using the $top query parameter. This example uses $top, to limit the response to three records.
HTTP/1.1 200 OK
Content-type: application/json
{
"id": "profileId",
"anniversaries": [],
"websites": [],
"educationalActivities": [
{
"endMonthYear": null,
"startMonthYear": null,
"completionMonthYear": null,
"allowedAudiences": "everyone",
"createdDateTime": "0001-01-01T00:00:00Z",
"inference": null,
"lastModifiedDateTime": "0001-01-01T00:00:00Z",
"id": "c3a9f515-4a15-456b-9bf7-690dcd7f05d7",
"program": {
"abbreviation": null,
"description": null,
"displayName": "",
"grade": null,
"notes": null,
"webUrl": null
},
"institution": {
"description": null,
"displayName": "Colorado State University",
"location": null,
"webUrl": null
},
"createdBy": {
"device": null,
"user": null,
"application": {
"displayName": "UPA",
"id": null
}
}
}
],
"emails": [
{
"address": "john.doe@contoso.com",
"displayName": null,
"type": "main",
"allowedAudiences": "everyone",
"createdDateTime": "0001-01-01T00:00:00Z",
"inference": null,
"lastModifiedDateTime": "0001-01-01T00:00:00Z",
"id": "046452c0-c893-4fd1-a7ca-57e2ccf13861",
"createdBy": {
"device": null,
"user": null,
"application": {
"displayName": "AAD",
"id": null
}
}
}
],
"interests": [
{
"categories": [],
"description": null,
"displayName": "Microsoft Graph",
"webUrl": null,
"allowedAudiences": "everyone",
"createdDateTime": "0001-01-01T00:00:00Z",
"inference": null,
"lastModifiedDateTime": "0001-01-01T00:00:00Z",
"id": "0c568cf5-5e44-4b3e-aefd-6b46ca00a880",
"createdBy": {
"device": null,
"user": null,
"application": {
"displayName": "UPA",
"id": null
}
}
}
],
"languages": [
{
"displayName": "English (United States)",
"tag": "en-US",
"proficiency": null,
"allowedAudiences": "everyone",
"createdDateTime": "0001-01-01T00:00:00Z",
"inference": null,
"lastModifiedDateTime": "0001-01-01T00:00:00Z",
"id": "3d34dc2e-fc84-43ff-98f6-884467caba72",
"createdBy": {
"device": null,
"user": null,
"application": {
"displayName": "AAD",
"id": null
}
}
}
],
"names": [
{
"displayName": "John Doe",
"first": "John",
"initials": "JD",
"last": "Doe",
"languageTag": null,
"maiden": null,
"middle": null,
"nickname": null,
"suffix": null,
"title": null,
"pronunciation": null,
"allowedAudiences": "everyone",
"createdDateTime": "0001-01-01T00:00:00Z",
"inference": null,
"lastModifiedDateTime": "0001-01-01T00:00:00Z",
"id": "b79302ca-7f05-4c89-96ce-b89d5855eb0e",
"createdBy": {
"device": null,
"user": null,
"application": {
"displayName": "AAD",
"id": null
}
}
}
],
"phones": [
{
"displayName": null,
"type": "business",
"number": "+47 (9) 387654321",
"allowedAudiences": "everyone",
"createdDateTime": "0001-01-01T00:00:00Z",
"inference": null,
"lastModifiedDateTime": "0001-01-01T00:00:00Z",
"id": "d22aef2c-f332-4958-aac3-8d1d710a9e32",
"createdBy": {
"device": null,
"user": null,
"application": {
"displayName": "AAD",
"id": null
}
}
}
],
"positions": [
{
"categories": [],
"allowedAudiences": "everyone",
"createdDateTime": "0001-01-01T00:00:00Z",
"inference": null,
"lastModifiedDateTime": "0001-01-01T00:00:00Z",
"id": "0f4d49c8-76cb-4d56-9f92-a10e182ba0e1",
"detail": {
"description": null,
"endMonthYear": "0001-01-01",
"jobTitle": "Associate Architect",
"startMonthYear": "0001-01-01",
"summary": null,
"company": {
"displayName": "Contoso Corporation",
"pronunciation": null,
"department": "Architecture",
"officeLocation": "",
"webUrl": null,
"address": {
"type": "business",
"postOfficeBox": null,
"street": "",
"city": "Oslo",
"state": "",
"countryOrRegion": "",
"postalCode": ""
}
}
},
"createdBy": {
"device": null,
"user": null,
"application": {
"displayName": "AAD",
"id": null
}
}
}
],
"projects": [
{
"categories": [],
"client": null,
"displayName": "Profile on Graph",
"detail": null,
"allowedAudiences": "everyone",
"createdDateTime": "0001-01-01T00:00:00Z",
"inference": null,
"lastModifiedDateTime": "0001-01-01T00:00:00Z",
"id": "d6d84567-513a-47be-9be2-99fee6a12777",
"colleagues": [],
"sponsors": [],
"createdBy": {
"device": null,
"user": null,
"application": {
"displayName": "UPA",
"id": null
}
}
}
],
"skills": [
{
"categories": [],
"displayName": "REST API Design",
"proficiency": null,
"webUrl": null,
"allowedAudiences": "everyone",
"createdDateTime": "0001-01-01T00:00:00Z",
"inference": null,
"lastModifiedDateTime": "0001-01-01T00:00:00Z",
"id": "9cd979f9-7a43-4dd1-a628-42bb07bd0974",
"createdBy": {
"device": null,
"user": null,
"application": {
"displayName": "UPA",
"id": null
}
}
}
],
"webAccounts": []
}