---
title: "Get List Items"
method: GET
path: "/Lists"
tags: ["Lists"]
---

# Get List Items

`GET /Lists`

**Auth:** Authenticated - any signed-in user.

Get a list of drive items for the given site, drive and folder

## Query parameters

- `siteId` string, nullable
- `listId` string, nullable
- `parentId` string, nullable
- `handbooks` boolean, nullable
- `page` integer, required
- `pageSize` integer, required
- `includes` string[], nullable
- `sort` string, nullable
- `filter` string, nullable

## Response `200`

Success - Got List Items

- GetListItemsResponse
  - `listItems` MicrosoftListItem[], nullable
    - `@odata.etag` string, nullable
    - `createdDateTime` string, nullable
    - `eTag` string, nullable
    - `id` string, nullable
    - `lastModifiedDateTime` string, nullable
    - `webUrl` string, nullable
    - `createdBy` ActionedBy
      - `user` FileUser
        - `email` string, nullable
        - `id` string, nullable
        - `displayName` string, nullable
    - `lastModifiedBy` ActionedBy
      - `user` FileUser
        - `email` string, nullable
        - `id` string, nullable
        - `displayName` string, nullable
    - `parentReference` ParentReference
      - `driveType` string, nullable
      - `driveId` string, nullable
      - `id` string, nullable
      - `path` string, nullable
    - `contentType` ContentType
      - `id` string, nullable
      - `name` string, nullable
    - `fields@odata.context` string, nullable
    - `fields` Fields
      - `@odata.etag` string, nullable
      - `Modified` string, nullable
      - `FileLeafRef` string, nullable
      - `MediaServiceImageTags` unknown[], nullable
        - unknown
      - `VisibleTo` string[], nullable
      - `Category` string, nullable
      - `NextUpdate` string, nullable
      - `Reference` string, nullable
      - `id` string, nullable
      - `ContentType` string, nullable
      - `Created` string, nullable
      - `AuthorLookupId` string, nullable
      - `EditorLookupId` string, nullable
      - `_CheckinComment` string, nullable
      - `LinkFilenameNoMenu` string, nullable
      - `LinkFilename` string, nullable
      - `DocIcon` string, nullable
      - `FileSizeDisplay` string, nullable
      - `ItemChildCount` string, nullable
      - `FolderChildCount` string, nullable
      - `_ComplianceFlags` string, nullable
      - `_ComplianceTag` string, nullable
      - `_ComplianceTagWrittenTime` string, nullable
      - `_ComplianceTagUserId` string, nullable
      - `_CommentCount` string, nullable
      - `_LikeCount` string, nullable
      - `_DisplayName` string, nullable
      - `Edit` string, nullable
      - `_UIVersionString` string, nullable
      - `ParentVersionStringLookupId` string, nullable
      - `ParentLeafNameLookupId` string, nullable
    - `fileName` string, nullable
    - `fileType` string, nullable
  - `meta` Meta
    - `page` integer
    - `pageSize` integer
    - `total` integer

## Other responses

- `400` — An Error Occurred - Could not get List Items
- `401` — Unauthorized

---

[API](https://skmtc.net/tonbridge/apis/tonbridge-app-api.md) · [All operations](https://skmtc.net/tonbridge/apis/tonbridge-app-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tonbridge/tonbridge-app-api/versions/fab57bf5558a/schema)