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

# List Host Profiles

`GET /servers/tdx/host_profiles`

## Request

- Base URL: `https://api.chutes.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.chutes.ai/servers/tdx/host_profiles`
- Auth: none declared

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

By default, only host classes that HAVE measurements. Each entry's `tee_type` says which
platform it attests under. Find `fingerprint` in the `fingerprints` of that platform's
measurements (GET /servers/tdx/measurements or /servers/snp/measurements), regenerate the
measurement from the
inputs here, and compare -- that makes every published measurement independently
reproducible, and a quote holder can see which host class their own measurement 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

- string

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-16** `23e8895b217d`: 1 breaking, 2 info
  - the response's body type changed from `array` to `string` for status `200`
  - added the optional property `detail/items/ctx` to the response with the `422` status
  - added the optional property `detail/items/input` to the response with the `422` status
- **2026-10-01** `7d7c1adba263`: 1 info
  - added the optional property `items/tee_type` to the response with the `200` status
- **2026-08-27** `7be1aa2fe1a0`: 1 info
  - added the required property `items/measurements` to the response with the `200` status
- **2026-08-27** `7d674931b6b5`: 3 info
  - added the new optional `query` request parameter `include_pending`
  - added the non-success response with the status `422`
  - added the required property `items/measured` to the response with the `200` status
- **2026-08-26** `8d909638091e`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/chutes/apis/chutes-api/changes/servers/tdx/host_profiles/get.md)

---

[API](https://skmtc.dev/chutes/apis/chutes-api.md) - [All operations](https://skmtc.dev/chutes/apis/chutes-api/llms.txt) - [OpenAPI document](https://skmtc.dev/chutes/apis/chutes-api/revisions/8add5b0e22da?raw)