---
title: "List Host Profiles"
method: GET
path: "/servers/tdx/host_profiles"
tags: ["Servers"]
---

# List Host Profiles

`GET /servers/tdx/host_profiles`

Return host profiles: the platform inputs a measurement is built from.

By default, only host classes that HAVE measurements. Join `fingerprint` to
GET /servers/tee/measurements, regenerate RTMR0 from the inputs here, and compare -- that makes
every published measurement independently reproducible, and a quote holder can see which host
class their own RTMR0 corresponds to. A third party needs no flags and can never be handed an
unverified claim.

`include_pending=true` also returns host classes awaiting generation. That is the measurement
generator's queue: a profile becomes measured only once measurements are generated for it, and
generation has to fetch it first. Each entry's `measured` flag says which set it is in.

Public and unauthenticated, so the generation side needs no database credentials. Every entry
is host-class data: the machine-identifying fields are dropped at submission and never stored,
and the submitter's `miner_hotkey` is a column this query never selects.

## Query parameters

- `include_pending` boolean — Also return host classes awaiting measurement generation.

## Response `200`

Successful Response

- HostProfileResponse[]
  - `fingerprint` string, required
  - `measured` boolean, required
  - `measurements` HostProfileMeasurement[], required
    - `version` string, required
    - `rc` boolean, required
  - `profile` object, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/chutes/apis/fastapi.md) · [All operations](https://skmtc.dev/chutes/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/chutes/fastapi/revisions/7be1aa2fe1a0/schema)
