---
title: "Inspect system directory"
method: GET
path: "/system/dir"
tags: ["system"]
---

# Inspect system directory

`GET /system/dir`

Returns the contents and disk usage of the specified directory path.

## Query parameters

- `path` string

## Response `200`

Directory contents and metadata.

- SystemDirResponse
  - `path` string, required — Absolute path of the inspected directory.
  - `totalBytes` integer — Total disk space on the volume containing the path in bytes.
  - `freeBytes` integer — Available disk space on the volume containing the path in bytes.
  - `directories` string[], required — Subdirectory names in the inspected directory.

---

[API](https://skmtc.dev/siafoundation/apis/hostd-api.md) · [All operations](https://skmtc.dev/siafoundation/apis/hostd-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/siafoundation/hostd-api/revisions/08ff756929fc/schema)