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

# GET /scs/file

`GET /scs/file`

## Request

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

> **Deprecated.**

Returns a FileData object representing the file with the given ID that is visible to the calling user.

## Query parameters

- `id` 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`: Invalid ID provided
- `500`: Server Exception

## Changes

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

- **2025-09-26** `45631f9bb3f0`: 1 warning, 3 info
  - removed the optional property `contentAction` from the response with the `200` status
  - endpoint deprecated
  - response property `attributes` deprecated
  - response property `type` deprecated
- **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 `attributes/deleteOn` to the response with the `200` status
- **2025-04-16** `75f764c843a9`: 1 breaking, 1 warning
  - added the new required `query` request parameter `id`
  - deleted the `path` request parameter `id`
- **2025-03-04** `53ced4917cd1`: 1 breaking, 1 warning
  - added the new path request parameter `id`
  - deleted the `query` request parameter `id`

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