---
title: "Get system volume info (total/free size)."
method: GET
path: "/systeminfo/volumes"
tags: ["systeminfo"]
---

# Get system volume info (total/free size).

`GET /systeminfo/volumes`

This endpoint is for retrieving system volume info that only provides for admin user.  Note that the response only reflects the storage status of local disk.

## Headers

- `X-Request-Id` string

## Response `200`

Get system volumes successfully.

- SystemInfo
  - `storage` Storage[] — The storage of system.
    - `total` integer — Total volume size.
    - `free` integer — Free volume size.

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not found
- `500` — Internal server error

---

[API](https://skmtc.dev/cerit/apis/harbor-api.md) · [All operations](https://skmtc.dev/cerit/apis/harbor-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/cerit/harbor-api/revisions/62d78801f8df/schema)