---
title: "GET /scs/list"
method: GET
path: "/scs/list"
tags: ["SCS V1"]
deprecated: true
---

# GET /scs/list

`GET /scs/list`

## Request

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

> **Deprecated.**

Returns a non-recursive list of FileData objects representing the files and subdirectories in the passed-in path directory that are visible to the calling user.

## Query parameters

- `count` integer
- `offset` integer
- `path` string, required
- `firstResult` integer
- `maxResults` integer

## Response `200`

Success

- FileData[]
  - `targetPath` string
  - `targetName` string
  - `id` string
  - `type` 'file' | 'folder' | 'summary'
  - `attributes` ScsFile
    - `fileName` string
    - `classificationMarking` string
    - `id` string
    - `path` string
    - `size` integer
    - `docType` string
    - `docTitle` string
    - `mediaTitle` string
    - `intrinsicTitle` string
    - `doi` string[]
    - `searchAfter` string
    - `serialNumber` string
    - `createdDate` string
    - `createdBy` string
    - `modifiedDate` string
    - `modifiedBy` string
    - `deleteOn` integer
    - `metaInfo` string
    - `ellipseLat` number, float
    - `ellipseLon` number, float
    - `milgridLat` number, float
    - `milgridLon` number, float
    - `milgrid` string
    - `read` string
    - `write` string
    - `name` string
    - `classification` string
    - `description` string
    - `keywords` string
    - `tags` string[]
    - `searchable` boolean

## Other responses

- `400`: Bad Request
- `403`: User not authorized to access passed path.
- `500`: Server Error

## Changes

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

- **2025-09-26** `45631f9bb3f0`: 1 warning, 4 info
  - removed the optional property `items/contentAction` from the response with the `200` status
  - endpoint deprecated
  - response property `items/` deprecated
  - response property `items/attributes` deprecated
  - …1 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/attributes/deleteOn` to the response with the `200` status

[Operation history](https://skmtc.dev/bluestaq/apis/unified-data-library-services-api/changes/scs/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)