---
title: "Returns storage that is for sale"
method: GET
path: "/sales/availability"
tags: ["Marketplace"]
---

# Returns storage that is for sale

`GET /sales/availability`

## Response `200`

Retrieved storage availabilities of the node

- SalesAvailabilityREAD[]
  - `totalSize` integer, required — Total size of availability's storage in bytes
  - `duration` integer, required — The duration of the request in seconds
  - `minPricePerBytePerSecond` string, required — Minimal price per byte per second paid (in amount of tokens) for the hosted request's slot for the request's duration as decimal string
  - `totalCollateral` string, required — Total collateral (in amount of tokens) that can be used for matching requests
  - `enabled` boolean — Enable the ability to receive sales on this availability.
  - `until` integer — Specifies the latest timestamp, after which the availability will no longer host any slots. If set to 0, there will be no restrictions.
  - `id` string, required — 32bits identifier encoded in hex-decimal string.
  - `freeSize` integer — Unused size of availability's storage in bytes as decimal string
  - `totalRemainingCollateral` string, required — Total collateral effective (in amount of tokens) that can be used for matching requests

## Other responses

- `500` — Error getting unused availabilities
- `503` — Persistence is not enabled

## Changes

- **2025-04-02** `c45fb5a40b67` — 3 breaking, 1 warning, 7 info
  - the `items/allOf[#/components/schemas/SalesAvailability]/duration` response's property type changed from `string` to `integer`, and format from no format to `int64` for status `200`
  - the `items/allOf[#/components/schemas/SalesAvailability]/totalSize` response's property type changed from `string` to `integer`, and format from no format to `int64` for status `200`
  - the `items/allOf[subschema #2]/freeSize` response's property type changed from `string` to `integer`, and format from no format to `int64` for status `200`
  - removed the optional property `items/allOf[#/components/schemas/SalesAvailability]/id` from the response with the `200` status
  - …7 more
- **2025-03-26** `3261a02e5377` — 2 info
  - added the optional property `items/allOf[#/components/schemas/SalesAvailability]/enabled` to the response with the `200` status
  - added the optional property `items/allOf[#/components/schemas/SalesAvailability]/until` to the response with the `200` status
- …earlier changes not shown

[Full history](https://skmtc.dev/logos-storage/apis/logos-storage-api/changes/sales/availability/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/c45fb5a40b67/schema)