Get profile
Namespace: microsoft.graph
Important
APIs under the /beta version in Microsoft Graph are subject to change. Use of these APIs in production applications is not supported. To determine whether an API is available in v1.0, use the Version selector.
Retrieve the properties and relationships of a profile object for a given user.
The profile resource exposes various rich properties that are descriptive of the user as relationships, for example, anniversaries and education activities. To get one of these navigation properties, use the corresponding GET method on that property. See the methods exposed by profile.
Permissions
One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.
| Permission type | Permissions (from least to most privileged) |
|---|---|
| Delegated (work or school account) | User.Read, User.ReadWrite, User.ReadBasic.All, User.Read.All, User.ReadWrite.All |
| Delegated (personal Microsoft account) | User.Read, User.ReadWrite, User.ReadBasic.All, User.Read.All, User.ReadWrite.All |
| Application | User.Read.All, User.ReadWrite.All |
HTTP request
GET /me/profile
GET /users/{id | userPrincipalName}/profile
Optional query parameters
This method supports the $select query parameter. Specify a list of properties to include in the response, separating them by commas. For optimal performance, only select the subset of properties needed.
Request headers
| Name | Description |
|---|---|
| Authorization | Bearer {token}. Required. |
| Content-Type | application/json. Required. |
Request body
Do not supply a request body for this method.
Response
If successful, this method returns a 200 OK response code and the requested profile object in the response body.
Examples
Example 1: GET a user's profile
The following is an example of the GET profile request.
Request
GET https://graph.microsoft.com/beta/me/profile
Response
The following is an example of the response.
Note: The response object shown here might be shortened for readability.
HTTP/1.1 200 OK
Content-type: application/json
{
"id": "34545-32444234-2334452-234332-432234",
"accounts": [],
"addresses": [
{
"id": "0fb4c1e3-c1e3-0fb4-e3c1-b40fe3c1b40f",
"allowedAudiences": "organization",
"inference": null,
"createdDateTime": "2020-07-06T06:34:12.2294868Z",
"createdBy": {
"application": null,
"device": null,
"user": {
"displayName": "Innocenty Popov",
"id": "db789417-4ccb-41d1-a0a9-47b01a09ea49"
}
},
"lastModifiedDateTime": "2020-07-06T06:34:12.2294868Z",
"lastModifiedBy": {
"application": null,
"device": null,
"user": {
"displayName": "Innocenty Popov",
"id": "db789417-4ccb-41d1-a0a9-47b01a09ea49"
}
},
"source": null,
"displayName": "Home",
"detail": {
"type": "home",
"postOfficeBox": null,
"street": "221B Baker Street",
"city": "London",
"state": null,
"countryOrRegion": "United Kingdom",
"postalCode": "E14 3TD"
},
"geoCoordinates": null
}
],
"anniversaries": [
{
"id": "0fb4c1e3-c1e3-0fb4-e3c1-b40fe3c1b40f",
"allowedAudiences": "organization",
"inference": null,
"createdDateTime": "2020-07-06T06:34:12.2294868Z",
"createdBy": {
"application": null,
"device": null,
"user": {
"displayName": "Innocenty Popov",
"id": "db789417-4ccb-41d1-a0a9-47b01a09ea49"
}
},
"lastModifiedDateTime": "2020-07-06T06:34:12.2294868Z",
"lastModifiedBy": {
"application": null,
"device": null,
"user": {
"displayName": "Innocenty Popov",
"id": "db789417-4ccb-41d1-a0a9-47b01a09ea49"
}
},
"type": "birthday",
"date": "Date"
}
],
"websites": [],
"educationalActivities": [],
"emails": [
{
"id": "e13f7a4d-303c-464f-a6af-80ea18eb74f3",
"allowedAudiences": "organization",
"inference": null,
"createdDateTime": "2020-07-06T06:34:12.2294868Z",
"createdBy": {
"user": {
"id": "efee1b77-fb3b-4f65-99d6-274c11914d12",
"displayName": "Innocenty Popov"
}
},
"lastModifiedDateTime": "2020-07-08T06:34:12.2294868Z",
"lastModifiedBy": {
"user": {
"id": "efee1b77-fb3b-4f65-99d6-274c11914d12",
"displayName": "Innocenty Popov"
}
},
"source": {
"type": "User"
},
"address": "innocenty.popov@adventureworks.com",
"displayName": "Innocenty Popov",
"type": "work"
}
],
"notes": [],
"interests": [],
"languages": [],
"names": [
{
"id": "0fb4c1e3-c1e3-0fb4-e3c1-b40fe3c1b40f",
"allowedAudiences": "organization",
"inference": null,
"createdDateTime": "2020-07-06T06:34:12.2294868Z",
"createdBy": {
"application": null,
"device": null,
"user": {
"displayName": "Innocenty Popov",
"id": "db789417-4ccb-41d1-a0a9-47b01a09ea49"
}
},
"lastModifiedDateTime": "2020-07-06T06:34:12.2294868Z",
"lastModifiedBy": {
"application": null,
"device": null,
"user": {
"displayName": "Innocenty Popov",
"id": "db789417-4ccb-41d1-a0a9-47b01a09ea49"
}
},
"displayName": "Innocenty Popov",
"first": "Innocenty",
"initials": "IP",
"last": "Popov",
"languageTag": "en-US",
"maiden": null,
"middle": null,
"nickname": "Kesha",
"suffix": null,
"title": null,
"pronunciation": {
"displayName": "In-no ken-te ",
"first": "In-no ken-te Pop-ov",
"maiden": null,
"middle": null,
"last": "Pop-ov"
}
}
],
"phones": [
{
"id": "0fb4c1e3-c1e3-0fb4-e3c1-b40fe3c1b40f",
"allowedAudiences": "organization",
"inference": null,
"createdDateTime": "2020-07-06T06:34:12.2294868Z",
"createdBy": {
"application": null,
"device": null,
"user": {
"displayName": "Innocenty Popov",
"id": "db789417-4ccb-41d1-a0a9-47b01a09ea49"
}
},
"lastModifiedDateTime": "2020-07-06T06:34:12.2294868Z",
"lastModifiedBy": {
"application": null,
"device": null,
"user": {
"displayName": "Innocenty Popov",
"id": "db789417-4ccb-41d1-a0a9-47b01a09ea49"
}
},
"displayName": "Car Phone",
"type": "other",
"number": "+7 499 342 22 13"
}
],
"positions": [],
"projects": [],
"skills": [],
"webAccounts": []
}
Example 2: Expand names and skills collection and select properties within the entities
The following is an example of using the $expand and $select query parameters to retrieve partial information from a user's profile.
Request
GET https://graph.microsoft.com/beta/me/profile?$expand=names($select=first,last),skills($select=displayName)
Response
The following is an example of the response.
Note: The response object shown here might be shortened for readability.
HTTP/1.1 200 OK
Content-type: application/json
{
"id": "34545-32444234-2334452-234332-432234",
"names": [
{
"first": "Innocenty",
"last": "Popov"
}
],
"skills": [
{
"displayName": "Machine Learning"
},
{
"displayName": "Artificial Intelligence"
}
]
}
Feedback
Submit and view feedback for