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.
Authorization
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.
View my profile
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": []
}
Feedback
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see: https://aka.ms/ContentUserFeedback.
Submit and view feedback for