me.mailFolder

Get mailFolder

Retrieve the properties and relationships of a mail folder object. You can specify a mail folder by its folder ID, or by its well-known folder name, if one exists.

get/me/mailFolders/{mailFolderId}

Query parameters

$selectstring[]

Select properties to be returned

$expandstring[]

Expand related entities

Response

Retrieved mail folder

@odata.typestring

idstring

The unique identifier for an entity. Read-only

childFolderCountnumber nullable

The number of immediate child mailFolders in the current mailFolder

parentFolderIdstring nullable

The unique identifier for the mailFolder's parent mailFolder

displayNamestring nullable

The mailFolder's display name

unreadItemCountnumber nullable

The number of items in the mailFolder marked as unread

isHiddenboolean nullable

Indicates whether the mailFolder is hidden. This property can be set only when creating the folder

totalItemCountnumber nullable

The number of items in the mailFolder

Changes

Changed in 4 of the 10 revisions of this API.163

Jul 17, 2026af62694b9f2d1See the full diff
- ○
  added the optional property allOf[subschema #2: mailFolder]/messages/items/allOf[subschema #2: message]/attachments/items/allOf[subschema #2: attachment]/contentBytes to the response with the 2XX status
  response-optional-property-added
May 27, 2026354d90657cdd1See the full diff
- ○
  api operation id me.GetMailFolders removed and replaced with getMailFolder
  api-operation-id-removed
May 26, 20265c775c50414c30See the full diff
- ○
  mapped value for discriminator key #microsoft.graph.attachment changed from microsoft.graph.attachment to MicrosoftGraphAttachment for allOf[subschema #1: entity]/ response property for the response status 2XX
  response-property-discriminator-mapping-changed
- ○
  mapped value for discriminator key #microsoft.graph.attachment changed from microsoft.graph.attachment to MicrosoftGraphAttachment for allOf[subschema #2: mailFolder]/messages/items/allOf[MicrosoftGraphOutlookItem]/allOf[subschema #1: entity]/ response property for the response status 2XX
  response-property-discriminator-mapping-changed
- ○
  mapped value for discriminator key #microsoft.graph.attachment changed from microsoft.graph.attachment to MicrosoftGraphAttachment for allOf[subschema #2: mailFolder]/messages/items/allOf[subschema #2: message]/attachments/items/allOf[subschema #1: entity]/ response property for the response status 2XX
  response-property-discriminator-mapping-changed
- ○
  mapped value for discriminator key #microsoft.graph.attachment changed from microsoft.graph.attachment to MicrosoftGraphAttachment for allOf[subschema #2: mailFolder]/messages/items/allOf[subschema #2: message]/extensions/items/allOf[subschema #1: entity]/ response property for the response status 2XX
  response-property-discriminator-mapping-changed
- ○
  mapped value for discriminator key #microsoft.graph.eventMessage changed from microsoft.graph.message to MicrosoftGraphMessage for allOf[subschema #2: mailFolder]/messages/items/allOf[subschema #2: message]/ response property for the response status 2XX
  response-property-discriminator-mapping-changed
- ○
  mapped value for discriminator key #microsoft.graph.fileAttachment changed from microsoft.graph.fileAttachment to MicrosoftGraphAttachment for allOf[subschema #1: entity]/ response property for the response status 2XX
  response-property-discriminator-mapping-changed
- ○
  mapped value for discriminator key #microsoft.graph.fileAttachment changed from microsoft.graph.fileAttachment to MicrosoftGraphAttachment for allOf[subschema #2: mailFolder]/messages/items/allOf[MicrosoftGraphOutlookItem]/allOf[subschema #1: entity]/ response property for the response status 2XX
  response-property-discriminator-mapping-changed
- ○
  mapped value for discriminator key #microsoft.graph.fileAttachment changed from microsoft.graph.fileAttachment to MicrosoftGraphAttachment for allOf[subschema #2: mailFolder]/messages/items/allOf[subschema #2: message]/attachments/items/allOf[subschema #1: entity]/ response property for the response status 2XX
  response-property-discriminator-mapping-changed
- ○
  mapped value for discriminator key #microsoft.graph.fileAttachment changed from microsoft.graph.fileAttachment to MicrosoftGraphAttachment for allOf[subschema #2: mailFolder]/messages/items/allOf[subschema #2: message]/attachments/items/allOf[subschema #2: attachment]/ response property for the response status 2XX
  response-property-discriminator-mapping-changed
- ○
  mapped value for discriminator key #microsoft.graph.fileAttachment changed from microsoft.graph.fileAttachment to MicrosoftGraphAttachment for allOf[subschema #2: mailFolder]/messages/items/allOf[subschema #2: message]/extensions/items/allOf[subschema #1: entity]/ response property for the response status 2XX
  response-property-discriminator-mapping-changed
- ○
  mapped value for discriminator key #microsoft.graph.itemAttachment changed from microsoft.graph.attachment to MicrosoftGraphAttachment for allOf[subschema #2: mailFolder]/messages/items/allOf[subschema #2: message]/attachments/items/allOf[subschema #2: attachment]/ response property for the response status 2XX
  response-property-discriminator-mapping-changed
- ○
  mapped value for discriminator key #microsoft.graph.mailFolder changed from microsoft.graph.mailFolder to MicrosoftGraphMailFolder for allOf[subschema #1: entity]/ response property for the response status 2XX
  response-property-discriminator-mapping-changed
- ○
  mapped value for discriminator key #microsoft.graph.mailFolder changed from microsoft.graph.mailFolder to MicrosoftGraphMailFolder for allOf[subschema #2: mailFolder]/messages/items/allOf[MicrosoftGraphOutlookItem]/allOf[subschema #1: entity]/ response property for the response status 2XX
  response-property-discriminator-mapping-changed
- ○
  mapped value for discriminator key #microsoft.graph.mailFolder changed from microsoft.graph.mailFolder to MicrosoftGraphMailFolder for allOf[subschema #2: mailFolder]/messages/items/allOf[subschema #2: message]/attachments/items/allOf[subschema #1: entity]/ response property for the response status 2XX
  response-property-discriminator-mapping-changed
- ○
  mapped value for discriminator key #microsoft.graph.mailFolder changed from microsoft.graph.mailFolder to MicrosoftGraphMailFolder for allOf[subschema #2: mailFolder]/messages/items/allOf[subschema #2: message]/extensions/items/allOf[subschema #1: entity]/ response property for the response status 2XX
  response-property-discriminator-mapping-changed
- ○
  mapped value for discriminator key #microsoft.graph.mailSearchFolder changed from microsoft.graph.mailSearchFolder to MicrosoftGraphMailFolder for allOf[subschema #1: entity]/ response property for the response status 2XX
  response-property-discriminator-mapping-changed
- ○
  mapped value for discriminator key #microsoft.graph.mailSearchFolder changed from microsoft.graph.mailSearchFolder to MicrosoftGraphMailFolder for allOf[subschema #2: mailFolder]/ response property for the response status 2XX
  response-property-discriminator-mapping-changed
- ○
  mapped value for discriminator key #microsoft.graph.mailSearchFolder changed from microsoft.graph.mailSearchFolder to MicrosoftGraphMailFolder for allOf[subschema #2: mailFolder]/messages/items/allOf[MicrosoftGraphOutlookItem]/allOf[subschema #1: entity]/ response property for the response status 2XX
  response-property-discriminator-mapping-changed
- ○
  mapped value for discriminator key #microsoft.graph.mailSearchFolder changed from microsoft.graph.mailSearchFolder to MicrosoftGraphMailFolder for allOf[subschema #2: mailFolder]/messages/items/allOf[subschema #2: message]/attachments/items/allOf[subschema #1: entity]/ response property for the response status 2XX
  response-property-discriminator-mapping-changed
- ○
  mapped value for discriminator key #microsoft.graph.mailSearchFolder changed from microsoft.graph.mailSearchFolder to MicrosoftGraphMailFolder for allOf[subschema #2: mailFolder]/messages/items/allOf[subschema #2: message]/extensions/items/allOf[subschema #1: entity]/ response property for the response status 2XX
  response-property-discriminator-mapping-changed
- ○
  mapped value for discriminator key #microsoft.graph.message changed from microsoft.graph.message to MicrosoftGraphMessage for allOf[subschema #1: entity]/ response property for the response status 2XX
  response-property-discriminator-mapping-changed
- ○
  mapped value for discriminator key #microsoft.graph.message changed from microsoft.graph.message to MicrosoftGraphMessage for allOf[subschema #2: mailFolder]/messages/items/allOf[MicrosoftGraphOutlookItem]/allOf[subschema #1: entity]/ response property for the response status 2XX
  response-property-discriminator-mapping-changed
- ○
  mapped value for discriminator key #microsoft.graph.message changed from microsoft.graph.message to MicrosoftGraphMessage for allOf[subschema #2: mailFolder]/messages/items/allOf[MicrosoftGraphOutlookItem]/allOf[subschema #2: outlookItem]/ response property for the response status 2XX
  response-property-discriminator-mapping-changed
- ○
  mapped value for discriminator key #microsoft.graph.message changed from microsoft.graph.message to MicrosoftGraphMessage for allOf[subschema #2: mailFolder]/messages/items/allOf[subschema #2: message]/attachments/items/allOf[subschema #1: entity]/ response property for the response status 2XX
  response-property-discriminator-mapping-changed
- ○
  mapped value for discriminator key #microsoft.graph.message changed from microsoft.graph.message to MicrosoftGraphMessage for allOf[subschema #2: mailFolder]/messages/items/allOf[subschema #2: message]/extensions/items/allOf[subschema #1: entity]/ response property for the response status 2XX
  response-property-discriminator-mapping-changed
- ○
  mapped value for discriminator key #microsoft.graph.outlookItem changed from microsoft.graph.outlookItem to MicrosoftGraphOutlookItem for allOf[subschema #1: entity]/ response property for the response status 2XX
  response-property-discriminator-mapping-changed
- ○
  mapped value for discriminator key #microsoft.graph.outlookItem changed from microsoft.graph.outlookItem to MicrosoftGraphOutlookItem for allOf[subschema #2: mailFolder]/messages/items/allOf[MicrosoftGraphOutlookItem]/allOf[subschema #1: entity]/ response property for the response status 2XX
  response-property-discriminator-mapping-changed
- ○
  mapped value for discriminator key #microsoft.graph.outlookItem changed from microsoft.graph.outlookItem to MicrosoftGraphOutlookItem for allOf[subschema #2: mailFolder]/messages/items/allOf[subschema #2: message]/attachments/items/allOf[subschema #1: entity]/ response property for the response status 2XX
  response-property-discriminator-mapping-changed
- ○
  mapped value for discriminator key #microsoft.graph.outlookItem changed from microsoft.graph.outlookItem to MicrosoftGraphOutlookItem for allOf[subschema #2: mailFolder]/messages/items/allOf[subschema #2: message]/extensions/items/allOf[subschema #1: entity]/ response property for the response status 2XX
  response-property-discriminator-mapping-changed
- ○
  mapped value for discriminator key #microsoft.graph.referenceAttachment changed from microsoft.graph.attachment to MicrosoftGraphAttachment for allOf[subschema #2: mailFolder]/messages/items/allOf[subschema #2: message]/attachments/items/allOf[subschema #2: attachment]/ response property for the response status 2XX
  response-property-discriminator-mapping-changed
May 26, 2026c6fc1d98f528131See the full diff
- ●
  removed the optional property allOf[subschema #2: mailFolder]/messages/items/allOf[subschema #2: message]/attachments/items/allOf[subschema #2: attachment]/contentBytes from the response with the 2XX status
  response-optional-property-removed
- ○
  api operation id getMailFolder removed and replaced with me.GetMailFolders
  api-operation-id-removed
- ○
  mapped value for discriminator key #microsoft.graph.attachment changed from MicrosoftGraphAttachment to microsoft.graph.attachment for allOf[subschema #1: entity]/ response property for the response status 2XX
  response-property-discriminator-mapping-changed
- ○
  mapped value for discriminator key #microsoft.graph.attachment changed from MicrosoftGraphAttachment to microsoft.graph.attachment for allOf[subschema #2: mailFolder]/messages/items/allOf[MicrosoftGraphOutlookItem]/allOf[subschema #1: entity]/ response property for the response status 2XX
  response-property-discriminator-mapping-changed
- ○
  mapped value for discriminator key #microsoft.graph.attachment changed from MicrosoftGraphAttachment to microsoft.graph.attachment for allOf[subschema #2: mailFolder]/messages/items/allOf[subschema #2: message]/attachments/items/allOf[subschema #1: entity]/ response property for the response status 2XX
  response-property-discriminator-mapping-changed
- ○
  mapped value for discriminator key #microsoft.graph.attachment changed from MicrosoftGraphAttachment to microsoft.graph.attachment for allOf[subschema #2: mailFolder]/messages/items/allOf[subschema #2: message]/extensions/items/allOf[subschema #1: entity]/ response property for the response status 2XX
  response-property-discriminator-mapping-changed
- ○
  mapped value for discriminator key #microsoft.graph.eventMessage changed from MicrosoftGraphMessage to microsoft.graph.message for allOf[subschema #2: mailFolder]/messages/items/allOf[subschema #2: message]/ response property for the response status 2XX
  response-property-discriminator-mapping-changed
- ○
  mapped value for discriminator key #microsoft.graph.fileAttachment changed from MicrosoftGraphAttachment to microsoft.graph.fileAttachment for allOf[subschema #1: entity]/ response property for the response status 2XX
  response-property-discriminator-mapping-changed
- ○
  mapped value for discriminator key #microsoft.graph.fileAttachment changed from MicrosoftGraphAttachment to microsoft.graph.fileAttachment for allOf[subschema #2: mailFolder]/messages/items/allOf[MicrosoftGraphOutlookItem]/allOf[subschema #1: entity]/ response property for the response status 2XX
  response-property-discriminator-mapping-changed
- ○
  mapped value for discriminator key #microsoft.graph.fileAttachment changed from MicrosoftGraphAttachment to microsoft.graph.fileAttachment for allOf[subschema #2: mailFolder]/messages/items/allOf[subschema #2: message]/attachments/items/allOf[subschema #1: entity]/ response property for the response status 2XX
  response-property-discriminator-mapping-changed
- ○
  mapped value for discriminator key #microsoft.graph.fileAttachment changed from MicrosoftGraphAttachment to microsoft.graph.fileAttachment for allOf[subschema #2: mailFolder]/messages/items/allOf[subschema #2: message]/attachments/items/allOf[subschema #2: attachment]/ response property for the response status 2XX
  response-property-discriminator-mapping-changed
- ○
  mapped value for discriminator key #microsoft.graph.fileAttachment changed from MicrosoftGraphAttachment to microsoft.graph.fileAttachment for allOf[subschema #2: mailFolder]/messages/items/allOf[subschema #2: message]/extensions/items/allOf[subschema #1: entity]/ response property for the response status 2XX
  response-property-discriminator-mapping-changed
- ○
  mapped value for discriminator key #microsoft.graph.itemAttachment changed from MicrosoftGraphAttachment to microsoft.graph.attachment for allOf[subschema #2: mailFolder]/messages/items/allOf[subschema #2: message]/attachments/items/allOf[subschema #2: attachment]/ response property for the response status 2XX
  response-property-discriminator-mapping-changed
- ○
  mapped value for discriminator key #microsoft.graph.mailFolder changed from MicrosoftGraphMailFolder to microsoft.graph.mailFolder for allOf[subschema #1: entity]/ response property for the response status 2XX
  response-property-discriminator-mapping-changed
- ○
  mapped value for discriminator key #microsoft.graph.mailFolder changed from MicrosoftGraphMailFolder to microsoft.graph.mailFolder for allOf[subschema #2: mailFolder]/messages/items/allOf[MicrosoftGraphOutlookItem]/allOf[subschema #1: entity]/ response property for the response status 2XX
  response-property-discriminator-mapping-changed
- ○
  mapped value for discriminator key #microsoft.graph.mailFolder changed from MicrosoftGraphMailFolder to microsoft.graph.mailFolder for allOf[subschema #2: mailFolder]/messages/items/allOf[subschema #2: message]/attachments/items/allOf[subschema #1: entity]/ response property for the response status 2XX
  response-property-discriminator-mapping-changed
- ○
  mapped value for discriminator key #microsoft.graph.mailFolder changed from MicrosoftGraphMailFolder to microsoft.graph.mailFolder for allOf[subschema #2: mailFolder]/messages/items/allOf[subschema #2: message]/extensions/items/allOf[subschema #1: entity]/ response property for the response status 2XX
  response-property-discriminator-mapping-changed
- ○
  mapped value for discriminator key #microsoft.graph.mailSearchFolder changed from MicrosoftGraphMailFolder to microsoft.graph.mailSearchFolder for allOf[subschema #1: entity]/ response property for the response status 2XX
  response-property-discriminator-mapping-changed
- ○
  mapped value for discriminator key #microsoft.graph.mailSearchFolder changed from MicrosoftGraphMailFolder to microsoft.graph.mailSearchFolder for allOf[subschema #2: mailFolder]/ response property for the response status 2XX
  response-property-discriminator-mapping-changed
- ○
  mapped value for discriminator key #microsoft.graph.mailSearchFolder changed from MicrosoftGraphMailFolder to microsoft.graph.mailSearchFolder for allOf[subschema #2: mailFolder]/messages/items/allOf[MicrosoftGraphOutlookItem]/allOf[subschema #1: entity]/ response property for the response status 2XX
  response-property-discriminator-mapping-changed
- ○
  mapped value for discriminator key #microsoft.graph.mailSearchFolder changed from MicrosoftGraphMailFolder to microsoft.graph.mailSearchFolder for allOf[subschema #2: mailFolder]/messages/items/allOf[subschema #2: message]/attachments/items/allOf[subschema #1: entity]/ response property for the response status 2XX
  response-property-discriminator-mapping-changed
- ○
  mapped value for discriminator key #microsoft.graph.mailSearchFolder changed from MicrosoftGraphMailFolder to microsoft.graph.mailSearchFolder for allOf[subschema #2: mailFolder]/messages/items/allOf[subschema #2: message]/extensions/items/allOf[subschema #1: entity]/ response property for the response status 2XX
  response-property-discriminator-mapping-changed
- ○
  mapped value for discriminator key #microsoft.graph.message changed from MicrosoftGraphMessage to microsoft.graph.message for allOf[subschema #1: entity]/ response property for the response status 2XX
  response-property-discriminator-mapping-changed
- ○
  mapped value for discriminator key #microsoft.graph.message changed from MicrosoftGraphMessage to microsoft.graph.message for allOf[subschema #2: mailFolder]/messages/items/allOf[MicrosoftGraphOutlookItem]/allOf[subschema #1: entity]/ response property for the response status 2XX
  response-property-discriminator-mapping-changed
- ○
  mapped value for discriminator key #microsoft.graph.message changed from MicrosoftGraphMessage to microsoft.graph.message for allOf[subschema #2: mailFolder]/messages/items/allOf[MicrosoftGraphOutlookItem]/allOf[subschema #2: outlookItem]/ response property for the response status 2XX
  response-property-discriminator-mapping-changed
- ○
  mapped value for discriminator key #microsoft.graph.message changed from MicrosoftGraphMessage to microsoft.graph.message for allOf[subschema #2: mailFolder]/messages/items/allOf[subschema #2: message]/attachments/items/allOf[subschema #1: entity]/ response property for the response status 2XX
  response-property-discriminator-mapping-changed
- ○
  mapped value for discriminator key #microsoft.graph.message changed from MicrosoftGraphMessage to microsoft.graph.message for allOf[subschema #2: mailFolder]/messages/items/allOf[subschema #2: message]/extensions/items/allOf[subschema #1: entity]/ response property for the response status 2XX
  response-property-discriminator-mapping-changed
- ○
  mapped value for discriminator key #microsoft.graph.outlookItem changed from MicrosoftGraphOutlookItem to microsoft.graph.outlookItem for allOf[subschema #1: entity]/ response property for the response status 2XX
  response-property-discriminator-mapping-changed
- ○
  mapped value for discriminator key #microsoft.graph.outlookItem changed from MicrosoftGraphOutlookItem to microsoft.graph.outlookItem for allOf[subschema #2: mailFolder]/messages/items/allOf[MicrosoftGraphOutlookItem]/allOf[subschema #1: entity]/ response property for the response status 2XX
  response-property-discriminator-mapping-changed
- ○
  mapped value for discriminator key #microsoft.graph.outlookItem changed from MicrosoftGraphOutlookItem to microsoft.graph.outlookItem for allOf[subschema #2: mailFolder]/messages/items/allOf[subschema #2: message]/attachments/items/allOf[subschema #1: entity]/ response property for the response status 2XX
  response-property-discriminator-mapping-changed
- ○
  mapped value for discriminator key #microsoft.graph.outlookItem changed from MicrosoftGraphOutlookItem to microsoft.graph.outlookItem for allOf[subschema #2: mailFolder]/messages/items/allOf[subschema #2: message]/extensions/items/allOf[subschema #1: entity]/ response property for the response status 2XX
  response-property-discriminator-mapping-changed
- ○
  mapped value for discriminator key #microsoft.graph.referenceAttachment changed from MicrosoftGraphAttachment to microsoft.graph.attachment for allOf[subschema #2: mailFolder]/messages/items/allOf[subschema #2: message]/attachments/items/allOf[subschema #2: attachment]/ response property for the response status 2XX
  response-property-discriminator-mapping-changed

Full history