Microsoft Graph · Schema
microsoft.graph.person
Microsoft GraphAzure ADCollaborationContactsDocumentsEmailGraphIdentityMicrosoftOffice 365PresentationsProductivitySpreadsheetsT1Task
Properties
| Name | Type | Description |
|---|---|---|
| birthday | string | The person's birthday. |
| companyName | string | The name of the person's company. |
| department | string | The person's department. |
| displayName | string | The person's display name. |
| givenName | string | The person's given name. |
| imAddress | string | The instant message voice over IP (VOIP) session initiation protocol (SIP) address for the user. Read-only. |
| isFavorite | boolean | True if the user has flagged this person as a favorite. |
| jobTitle | string | The person's job title. |
| officeLocation | string | The location of the person's office. |
| personNotes | string | Free-form notes that the user has taken about this person. |
| personType | object | The type of person. |
| phones | array | The person's phone numbers. |
| postalAddresses | array | The person's addresses. |
| profession | string | The person's profession. |
| scoredEmailAddresses | array | The person's email addresses. |
| surname | string | The person's surname. |
| userPrincipalName | string | The user principal name (UPN) of the person. The UPN is an Internet-style login name for the person based on the Internet standard RFC 822. By convention, this should map to the person's email name. T |
| websites | array | The person's websites. |
| yomiCompany | string | The phonetic Japanese name of the person's company. |
| @odata.type | string |
JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "#/components/schemas/microsoft.graph.person",
"title": "microsoft.graph.person",
"allOf": [
{
"$ref": "#/components/schemas/microsoft.graph.entity"
},
{
"title": "person",
"required": [
"@odata.type"
],
"type": "object",
"properties": {
"birthday": {
"type": "string",
"description": "The person's birthday.",
"nullable": true
},
"companyName": {
"type": "string",
"description": "The name of the person's company.",
"nullable": true
},
"department": {
"type": "string",
"description": "The person's department.",
"nullable": true
},
"displayName": {
"type": "string",
"description": "The person's display name.",
"nullable": true
},
"givenName": {
"type": "string",
"description": "The person's given name.",
"nullable": true
},
"imAddress": {
"type": "string",
"description": "The instant message voice over IP (VOIP) session initiation protocol (SIP) address for the user. Read-only.",
"nullable": true
},
"isFavorite": {
"type": "boolean",
"description": "True if the user has flagged this person as a favorite.",
"nullable": true
},
"jobTitle": {
"type": "string",
"description": "The person's job title.",
"nullable": true
},
"officeLocation": {
"type": "string",
"description": "The location of the person's office.",
"nullable": true
},
"personNotes": {
"type": "string",
"description": "Free-form notes that the user has taken about this person.",
"nullable": true
},
"personType": {
"anyOf": [
{
"$ref": "#/components/schemas/microsoft.graph.personType"
},
{
"type": "object",
"nullable": true
}
],
"description": "The type of person."
},
"phones": {
"type": "array",
"items": {
"$ref": "#/components/schemas/microsoft.graph.phone"
},
"description": "The person's phone numbers."
},
"postalAddresses": {
"type": "array",
"items": {
"$ref": "#/components/schemas/microsoft.graph.location"
},
"description": "The person's addresses."
},
"profession": {
"type": "string",
"description": "The person's profession.",
"nullable": true
},
"scoredEmailAddresses": {
"type": "array",
"items": {
"$ref": "#/components/schemas/microsoft.graph.scoredEmailAddress"
},
"description": "The person's email addresses."
},
"surname": {
"type": "string",
"description": "The person's surname.",
"nullable": true
},
"userPrincipalName": {
"type": "string",
"description": "The user principal name (UPN) of the person. The UPN is an Internet-style login name for the person based on the Internet standard RFC 822. By convention, this should map to the person's email name. The general format is alias@domain.",
"nullable": true
},
"websites": {
"type": "array",
"items": {
"$ref": "#/components/schemas/microsoft.graph.website"
},
"description": "The person's websites."
},
"yomiCompany": {
"type": "string",
"description": "The phonetic Japanese name of the person's company.",
"nullable": true
},
"@odata.type": {
"type": "string"
}
}
}
],
"x-ms-discriminator-value": "#microsoft.graph.person"
}
Work with this as data
Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for schemas
4 MCP tools reach this
find_json_schemasBrowse and filter every JSON Schema in the catalog.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/microsoft-graph-microsoftgraphperson"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.