> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sarasfinance.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List Process Storage

> Retrieve a paginated list of files associated with processes in a sub-project.

### Query Parameters

<ParamField query="subProjectId" type="string" placeholder="sp_123" required>
  The unique identifier for the sub-project.
</ParamField>

<ParamField query="page" type="string" placeholder="1">
  Pagination page number (optional).
</ParamField>

<ParamField query="perPageCount" type="string" placeholder="10">
  Number of results per page (optional).
</ParamField>

<ParamField query="filters" type="json" placeholder="{}">
  JSON string of filters to apply (e.g. search by filename or stageKey).
</ParamField>

### Response

<ResponseField name="meta" type="object">
  <Expandable title="properties">
    <ResponseField name="page" type="string">
      Current page number.
    </ResponseField>

    <ResponseField name="perPageCount" type="string">
      Items per page.
    </ResponseField>

    <ResponseField name="totalCount" type="string">
      Total matching files count.
    </ResponseField>

    <ResponseField name="totalPages" type="string">
      Total pages available.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="files" type="object[]">
  <Expandable title="properties">
    <ResponseField name="id" type="string">
      Unique ID of the file.
    </ResponseField>

    <ResponseField name="fileName" type="string">
      Name of the file.
    </ResponseField>

    <ResponseField name="size" type="string">
      File size in bytes.
    </ResponseField>

    <ResponseField name="locked" type="boolean">
      File lock state.
    </ResponseField>

    <ResponseField name="createdTs" type="string">
      ISO timestamp of creation.
    </ResponseField>
  </Expandable>
</ResponseField>

<RequestExample>
  ```bash theme={null}
  curl --location 'https://api.sarasfinance.com/v1/process/knowledges/listStorage?subProjectId=93d599a6-a396-4ef6-b30e-aff95c56c523&page=1&perPageCount=10' \
  --header 'Authorization: Bearer <token>'
  ```
</RequestExample>

<ResponseExample>
  ```json theme={null}
  {
    "meta": {
      "page": "1",
      "perPageCount": "10",
      "totalCount": "1",
      "totalPages": "1"
    },
    "files": [
      {
        "id": "file_cf90172b",
        "fileName": "litigation_brief.txt",
        "size": "12",
        "locked": false,
        "createdTs": "2026-04-15T19:52:25Z"
      }
    ]
  }
  ```
</ResponseExample>

### Error Codes

| Code                                       | ID   | Description                       |
| :----------------------------------------- | :--- | :-------------------------------- |
| `ERROR_PROCESS_META_IS_MISSING_IN_REQUEST` | 1200 | Metadata missing in request       |
| `ERROR_SUBPROCESS_META_NOT_FOUND`          | 1202 | Sub-project metadata not found    |
| `ERROR_NOT_ALLOWED_TO_GET`                 | 1205 | User unauthorized to view storage |