---
title: "Get host state"
method: GET
path: "/state"
tags: ["state"]
---

# Get host state

`GET /state`

Returns general metadata about the hostd instance.

## Response `200`

Current host state.

- State
  - `version` string, required — Semantic version of the hostd build.
  - `commit` string, required — Git commit hash of the build.
  - `os` string, required — Operating system the host is running on.
  - `buildTime` string, date-time, required — Timestamp when the build was created.
  - `name` string, nullable — User-defined name of the host.
  - `publicKey` string, required — Ed25519 public key with prefix.
  - `lastAnnouncement` Announcement, required
    - `index` ChainIndex, required
      - `height` integer, required — Block height.
      - `id` string, required — 256-bit blake2b hash.
    - `address` string, required — The host's announced network address.
  - `startTime` string, date-time, required — Time the hostd process started.
  - `explorer` ExplorerState, required
    - `enabled` boolean, required — Whether the explorer data source is enabled.
    - `url` string — Base URL of the explorer data source. Empty if not enabled.

## Changes

> 8 revisions in range; 1 could not be searched.

- **2025-10-08** `103993fc0091` — 1 breaking
  - the response property `allOf[subschema #2]/explorer/url` became nullable for the status `200`

[Change history](https://skmtc.dev/siafoundation/apis/hostd-api/changes/state/get.md)

---

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