---
title: "GET /scs/v2/list"
method: GET
path: "/scs/v2/list"
tags: ["File/Folder Operations"]
---

# GET /scs/v2/list

`GET /scs/v2/list`

## Request

- Base URL: `https://unifieddatalibrary.com`
- URL: `https://unifieddatalibrary.com/scs/v2/list`
- Auth: none declared

Returns a list of ScsEntity objects, each directly nested under the provided path.

## Query parameters

- `order` string
- `path` string, required
- `searchAfter` string
- `size` integer
- `sort` string
- `firstResult` integer
- `maxResults` integer

## Response `200`

Success

- ScsEntity[]
  - `id` string: Unique identifier for document.
  - `classificationMarking` string: Classification marking of the folder or file in IC/CAPCO portion-marked format.
  - `createdBy` string: The creator of this document. Can be a person or a software entity.
  - `createdAt` string: The time at which this document was created, represented in UTC ISO format.
  - `updatedBy` string: The person or software entity who updated this document most recently.
  - `updatedAt` string: The time at which this document was most recently updated, represented in UTC ISO format.
  - `filename` string: The name of this document. Applicable to files and folders.
  - `filePath` string: The absolute path to this document.
  - `parentPath` string: The parent folder of this document. If this document is a root-level folder then the parent path is "/".
  - `pathType` 'file' | 'folder': The type of this document.
  - `keywords` string: Optional. Any keywords associated with this document. Only applicable to files whose contents are indexed (e.g. text files, PDFs).
  - `description` string: Optional description for the file or folder.
  - `readAcl` string: For folders only. Comma separated list of user and group ids that should have read access on this folder and the items nested in it.
  - `writeAcl` string: For folders only. Comma separated list of user and group ids that should have write access on this folder and the items nested in it.
  - `tags` string[]: Array of provider/source specific tags for this data, used for implementing data owner conditional access controls to restrict access to the data.
  - `attachment` Attachment
    - `date` string: The time at which this attachment was created, represented in UTC ISO format.
    - `keywords` string: Any keywords associated with this document. Only applicable to files whose contents are indexed (e.g. text files, PDFs).
    - `content_type` string: The document's MIME-type (if applicable).
    - `author` string: The creator of this document. Can be a person or a software entity.
    - `language` string: The human language of the document, if discernible.
    - `title` string: The title of the document.
    - `content_length` integer: The length of the document, in bytes.
  - `size` integer: Size of this document in bytes.
  - `deleteOn` integer: Time at which this document should be automatically deleted. Represented in milliseconds since Unix epoch.

## Other responses

- `400`: Bad Request. See message for details.
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Can not find provided path.
- `500`: Server Error. See message for details.

## Changes

> 12 revisions in range; 1 could not be searched.

- **2025-10-23** `09bd422d5ac1`: 2 info
  - added the non-success response with the status `401`
  - added the non-success response with the status `403`
- **2025-09-26** `45631f9bb3f0`: 12 warning, 8 info
  - removed the optional property `items/attachment/author` from the response with the `200` status
  - removed the optional property `items/attachment/content` from the response with the `200` status
  - removed the optional property `items/attachment/content_length` from the response with the `200` status
  - removed the optional property `items/attachment/content_type` from the response with the `200` status
  - …16 more
- **2025-05-29** `4e1cbc17e814`: 3 info
  - added the new optional `query` request parameter `firstResult`
  - added the new optional `query` request parameter `maxResults`
  - added the optional property `items/deleteOn` to the response with the `200` status

[Operation history](https://skmtc.dev/bluestaq/apis/unified-data-library-services-api/changes/scs/v2/list/get.md)

---

[API](https://skmtc.dev/bluestaq/apis/unified-data-library-services-api.md) - [All operations](https://skmtc.dev/bluestaq/apis/unified-data-library-services-api/llms.txt) - [OpenAPI document](https://skmtc.dev/bluestaq/apis/unified-data-library-services-api/revisions/bd17bc53681e?raw)