---
title: "Returns purchase details"
method: GET
path: "/storage/purchases/{id}"
tags: ["Marketplace"]
---

# Returns purchase details

`GET /storage/purchases/{id}`

## Path parameters

- `id` string, required

## Response `200`

Purchase details

- Purchase
  - `state` string — Description of the Request's state
  - `error` string — If Request failed, then here is presented the error message
  - `request` StorageRequest
    - `id` string — Request ID
    - `client` string — Address of Ethereum address
    - `ask` StorageAsk
      - `slots` number — Number of slots (eq. hosts) that the Request want to have the content spread over
      - `slotSize` string — Amount of storage per slot (in bytes) as decimal string
      - `duration` string — The duration of the request in seconds as decimal string
      - `proofProbability` string — How often storage proofs are required as decimal string
      - `reward` string, required — The maximum amount of tokens paid per second per slot to hosts the client is willing to pay
      - `maxSlotLoss` number — Max slots that can be lost without data considered to be lost
    - `content` Content — Parameters specifying the content
      - `cid` string — Content Identifier as specified at https://github.com/multiformats/cid
      - `erasure` ErasureParameters
        - `totalChunks` number
      - `por` PoRParameters — Parameters for Proof of Retrievability
        - `u` string
        - `publicKey` string
        - `name` string
    - `expiry` string — 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 — Random data

## Other responses

- `400` — Invalid or missing Purchase ID
- `404` — Purchase not found
- `503` — Purchasing is unavailable

## Changes

- **2023-12-07** `2fad26190d56` — 1 breaking, 3 info
  - the response's body type changed from `array` to `object` for status `200`
  - added the optional property `error` to the response with the `200` status
  - added the optional property `request` to the response with the `200` status
  - added the optional property `state` to the response with the `200` status
- **2023-06-20** `d2af5578290d` — 1 info
  - added the optional property `items/request/id` to the response with the `200` status
- **2023-03-30** `4e1dfb89fa19` — 1 info
  - api operation id `getStorageRequestState` removed and replaced with `getPurchase`
- **2023-03-15** `dfe487dfc0e2` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/logos-storage/apis/logos-storage-api/changes/storage/purchases/:id/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/64a4e4f07d65/schema)