List children of a driveItem

Return a collection of DriveItems in the children relationship of a DriveItem.

DriveItems with a non-null folder or package facet can have one or more child DriveItems.

Prerequisites

One of the following scopes is required to execute this API:

  • Files.Read
  • Files.ReadWrite

HTTP request

GET /me/drive/root/children
GET /me/drive/items/{item-id}/children
GET /me/drive/root:/{item-path}:/children
GET /drives/{drive-id}/items/{item-id}/children
GET /groups/{group-id}/drive/root/children
GET /groups/{group-id}/drive/items/{item-id}

Optional query parameters

This method supports the OData Query Parameters to help customize the response.

Request headers

Name Type Description
if-none-match String If this request header is included and the eTag (or cTag) provided matches the current tag on the file, an HTTP 304 Not Modified response is returned.

Request body

Do not supply a request body for this method.

Example

Request

Here is an example request to return the DriveItems in the root folder of the current user's OneDrive.

GET https://graph.microsoft.com/beta/me/drive/root/children

Response

Here is an example of the response.

HTTP/1.1 200 OK
Content-type: application/json

{
  "value": [
    {"name": "myfile.jpg", "size": 2048, "file": {} },
    {"name": "Documents", "folder": { "childCount": 4} },
    {"name": "Photos", "folder": { "childCount": 203} },
    {"name": "my sheet(1).xlsx", "size": 197 }
  ],
  "@odata.nextLink": "https://..."
}

Note: If a collection exceeds the default page size (200 items), the @odata.nextLink property is returned in the response to indicate more items are available and provide the request URL for the next page of items.

You can control the page size through optional query string parameters