---
title: "Gets a summary of the storage space allocation of the node."
method: GET
path: "/space"
tags: ["Data"]
---

# Gets a summary of the storage space allocation of the node.

`GET /space`

## Response `200`

Summary of storage allocation

- Space
  - `totalBlocks` integer, required — Number of blocks stored by the node
  - `quotaMaxBytes` integer, required — Maximum storage space (in bytes) available for the node in Logos Storage's local repository.
  - `quotaUsedBytes` integer, required — Amount of storage space (in bytes) currently used for storing files in Logos Storage's local repository.
  - `quotaReservedBytes` integer, required — Amount of storage reserved (in bytes) in the Logos Storage's local repository for future use when storage requests will be picked up and hosted by the node using node's availabilities. This does not include the storage currently in use.

## Other responses

- `500` — It's not working as planned

## Changes

- **2025-04-02** `c45fb5a40b67` — 4 info
  - the response property `quotaMaxBytes` became required for the status `200`
  - the response property `quotaReservedBytes` became required for the status `200`
  - the response property `quotaUsedBytes` became required for the status `200`
  - the response property `totalBlocks` became required for the status `200`
- **2024-06-06** `fc61f6d3a744` — 4 breaking
  - the `quotaMaxBytes` response's property type/format changed from `integer`/`uint64` to `integer`/`int64` for status `200`
  - the `quotaReservedBytes` response's property type/format changed from `integer`/`uint64` to `integer`/`int64` for status `200`
  - the `quotaUsedBytes` response's property type/format changed from `integer`/`uint64` to `integer`/`int64` for status `200`
  - the `totalBlocks` response's property type/format changed from `integer`/`uint64` to `integer`/`int64` for status `200`
- **2023-12-14** `2a4e831083b5` — 1 info
  - endpoint added
- **2023-03-15** `dfe487dfc0e2` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/logos-storage/apis/logos-storage-api/changes/space/get.md)

---

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