---
title: "Get upload parameters"
method: GET
path: "/bus/params/upload"
tags: ["bus"]
---

# Get upload parameters

`GET /bus/params/upload`

Returns parameters needed for uploads including consensus height, gouging parameters and upload packing status.

## Response `200`

Successfully retrieved upload parameters

- object
  - `currentHeight` integer — Current consensus height
  - `uploadPacking` boolean — Whether upload packing is enabled
  - `consensusState` ConsensusState
    - `blockHeight` integer — The current block height
    - `lastBlockTime` string, date-time — The time of the last block
    - `synced` boolean — Whether the node is synced with the network
  - `gougingSettings` GougingSettings
    - `maxRPCPrice` string — The maximum base price a host can charge per RPC
    - `maxContractPrice` string — The maximum price a host can charge for a contract formation
    - `maxDownloadPrice` string — The maximum price a host can charge for downloading in hastings / byte
    - `maxUploadPrice` string — The maximum price a host can charge for uploading in hastings / byte
    - `maxStoragePrice` string — The maximum price a host can charge for storage in hastings / byte / block
    - `hostBlockHeightLeeway` integer — The number of blocks a host's chain's height can diverge from our own before we stop using it
    - `minPriceTableValidity` integer — The time a host's price table should be valid after acquiring it in milliseconds
    - `minAccountExpiry` integer — The minimum amount of time an account on a host can be idle for before expiring
    - `minMaxEphemeralAccountBalance` string — The minimum max balance a host should allow us to fund an account with
  - `redundancySettings` RedundancySettings
    - `minShards` integer — The number of data shards a piece of an object gets erasure-coded into
    - `totalShards` integer — The number of total data shards a piece of an object gets erasure-coded into

## Other responses

- `500` — Internal server error

## Changes

- **2025-01-23** `c38282599c5a` — 2 breaking
  - the `allOf[#/components/schemas/GougingParams]/redundancySettings/minShards` response's property type/format changed from `integer`/`int32` to `integer`/`uint8` for status `200`
  - the `allOf[#/components/schemas/GougingParams]/redundancySettings/totalShards` response's property type/format changed from `integer`/`int32` to `integer`/`uint8` for status `200`
- **2024-12-18** `922f156353c9` — 1 breaking, 1 info
  - removed the media type `text/plain` for the response with the status `500`
  - api tag `bus` added
- **2024-12-17** `6bb182f7a7d2` — 1 info
  - endpoint added
- **2024-12-09** `f062c35d8f47` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/siafoundation/apis/renterd-api/changes/bus/params/upload/get.md)

---

[API](https://skmtc.dev/siafoundation/apis/renterd-api.md) · [All operations](https://skmtc.dev/siafoundation/apis/renterd-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/siafoundation/renterd-api/revisions/184a3d5207da/schema)