---
title: "Returns active slot with id {slotId} for the host"
method: GET
path: "/sales/slots/{slotId}"
tags: ["Marketplace"]
---

# Returns active slot with id {slotId} for the host

`GET /sales/slots/{slotId}`

## Path parameters

- `slotId` string, required — Content Identifier as specified at https://github.com/multiformats/cid

## Response `200`

Retrieved active slot

- SlotAgent
  - `slotIndex` integer, required — Slot Index number
  - `requestId` string, required — 32bits identifier encoded in hex-decimal string.
  - `request` StorageRequest
    - `id` string, required — Request ID
    - `client` string, required — Address of Ethereum address
    - `ask` StorageAsk, required
      - `slots` integer, required — Number of slots (eq. hosts) that the Request want to have the content spread over
      - `slotSize` integer, required — Amount of storage per slot in bytes
      - `duration` integer, required — The duration of the request in seconds
      - `proofProbability` string, required — How often storage proofs are required as decimal string
      - `pricePerBytePerSecond` string, required — The amount of tokens paid per byte per second per slot to hosts the client is willing to pay
      - `collateralPerByte` string, required — Number as decimal string that represents how much collateral per byte is asked from hosts that wants to fill a slots
      - `maxSlotLoss` integer, required — Max slots that can be lost without data considered to be lost
    - `content` Content, required — Parameters specifying the content
      - `cid` string, required — Content Identifier as specified at https://github.com/multiformats/cid
    - `expiry` integer, required — A timestamp as seconds since unix epoch at which this request expires if the Request does not find requested amount of nodes to host the data.
    - `nonce` string, required — Random data
  - `reservation` Reservation
    - `id` string, required — 32bits identifier encoded in hex-decimal string.
    - `availabilityId` string, required — 32bits identifier encoded in hex-decimal string.
    - `size` integer, required — Size of the slot in bytes
    - `requestId` string, required — 32bits identifier encoded in hex-decimal string.
    - `slotIndex` integer, required — Slot Index number
    - `validUntil` integer, required — Timestamp after which the reservation will no longer be valid.
  - `state` 'SaleCancelled' | 'SaleDownloading' | 'SaleErrored' | 'SaleFailed' | 'SaleFilled' | 'SaleFilling' | 'SaleFinished' | 'SaleIgnored' | 'SaleInitialProving' | 'SalePayout' | 'SalePreparing' | 'SaleProving' | 'SaleUnknown', required — Description of the slot's

## Other responses

- `400` — Invalid or missing SlotId
- `404` — Host is not in an active sale for the slot
- `503` — Persistence is not enabled

## Changes

- **2025-04-04** `ee092cd3ee0a` — 1 info
  - added the required property `request/ask/collateralPerByte` to the response with the `200` status
- **2025-04-02** `c45fb5a40b67` — 6 breaking, 1 warning, 22 info
  - the `request/ask/duration` response's property type changed from `string` to `integer`, and format from no format to `int64` for status `200`
  - the `request/ask/slotSize` response's property type changed from `string` to `integer`, and format from no format to `int64` for status `200`
  - the `request/expiry` response's property type changed from `string` to `integer`, and format from no format to `int64` for status `200`
  - the `reservation/size` response's property type changed from `string` to `integer`, and format from no format to `int64` for status `200`
  - …25 more
- **2025-03-26** `3261a02e5377` — 1 info
  - added the optional property `reservation/validUntil` to the response with the `200` status
- **2025-01-24** `03c5cc35cc9e` — 1 breaking, 1 info
  - removed the required property `request/ask/reward` from the response with the `200` status
  - added the required property `request/ask/pricePerBytePerSecond` to the response with the `200` status
- **2024-09-25** `29f962984779` — 2 warning
  - removed the optional property `request/content/erasure` from the response with the `200` status
  - removed the optional property `request/content/por` from the response with the `200` status

[Full history](https://skmtc.dev/logos-storage/apis/logos-storage-api/changes/sales/slots/:slotId/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.dev/logos-storage/apis/logos-storage-api/revisions/249e8b144116?raw)