---
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

---

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