---
title: "POST /scs/v2/search"
method: POST
path: "/scs/v2/search"
tags: ["File/Folder Operations"]
---

# POST /scs/v2/search

`POST /scs/v2/search`

## Request

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

Operation to search for files in the Secure Content Store.

## Query parameters

- `order` string
- `searchAfter` string
- `size` integer
- `sort` string

## Request body

- ScsSearchRequest: Top-level query object containing search criteria.
  - `query` union: A search criterion, which can be a simple field comparison or a logical combination of other criteria.
    - object: A search on a specific field with a given value and operator.
      - `field` string: The field to search on (e.g., attachment.content, createdBy).
      - `operator` 'EXACT_MATCH' | 'WILDCARD' | 'FUZZY' | 'GTE' | 'LTE' | 'GT' | 'LT': Supported search operators
      - `value` string: The value to compare against (e.g., The Great Gatsby)
    - object: Combines multiple search criteria with a logical operator (AND, OR, NOT).
      - `operator` 'AND' | 'OR' | 'NOT': Supported search operators
      - `criteria` ScsSearchCriterion[]: List of search criteria to combine

## 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
- `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`: 1 info
  - endpoint added

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