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

# Get gouging parameters

`GET /bus/params/gouging`

Returns the current gouging parameters including consensus state, gouging settings, and redundancy settings.

## Response `200`

Successfully retrieved gouging parameters

- object
  - `consensusState` object
    - `blockHeight` integer — The height of a block
    - `lastBlockTime` string, date-time — Timestamp of the last block
    - `synced` boolean — Whether consensus is synced
  - `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 `redundancySettings/minShards` response's property type/format changed from `integer`/`int32` to `integer`/`uint8` for status `200`
  - the `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/gouging/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)