---
title: "Get usable hosts"
method: GET
path: "/bus/hosts"
---

# Get usable hosts

`GET /bus/hosts`

Returns a list of hosts that pass the gouging checks

## Response `200`

List of usable hosts

- HostInfo[]
  - `publicKey` string — A ed25519 public key
  - `siamuxAddr` string — The address of the host
  - `v2SiamuxAddresses` string[]

## Other responses

- `500` — Internal server error

## Changes

- **2024-12-17** `acbb46c060cb` — 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/hosts/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.dev/siafoundation/apis/renterd-api/revisions/6bb182f7a7d2?raw)