# Get Host

`GET /vault/hyok/hosts/{host_id}` · Keys & Secrets · HYOK Clusters & Hosts

Returns one HYOK host. Needs `ORG_ADMIN`.

## Parameters

| Name | In | Required | Description |
|---|---|---|---|
| `orgId` | query | yes | The organisation's id. Example: `"org_O3QAqchb6v7d"`. |
| `host_id` | path | yes | The host's id: `hyokhost_` and a UUID. Example: `"hyokhost_8c1b3d5f-7a9e-4c2d-8e6f-0a1b2c3d4e5f"`. |

## Responses

- **200**: The host.

| Field | Type | Required | Description |
|---|---|---|---|
| `caRef` | string | yes | Secret-store handle for the customer's server trust-anchor CA. Example: `"secret://hyok/kmip-server-ca"`. |
| `clientCertRef` | string | yes | Secret-store handle for the platform mTLS client identity. Example: `"secret://hyok/kmip-client-identity"`. |
| `clusterId` | string \| null | no | Cluster identifier; non-null iff `status == in_cluster`. Example: `"hyokcluster_0b6f2c1e-3d4a-4b5c-8d9e-0f1a2b3c4d5e"`. |
| `createdAt` | string (date-time) | yes | Host registration timestamp. Example: `"2026-11-01T08:00:00.000Z"`. |
| `hostname` | string | yes | KMIP manager hostname (matches the server-cert SAN). Example: `"kmip.acme.example"`. |
| `hsmModel` | enum ("thales-luna", "entrust-nshield", "aws-cloudhsm") | yes | HSM model variants supported in the HYOK host registry. |
| `id` | string | yes | Host identifier — UUID prefixed `"hyokhost_"`. Example: `"hyokhost_9e8d7c6b-5a49-4f3e-8d2c-1b0a9f8e7d6c"`. |
| `label` | string | yes | Human-readable label (e.g., `"luna-prod-01"`). Example: `"luna-prod-01"`. |
| `orgId` | string | yes | Owning org. Example: `"org_8kP3wQ9zLm2X"`. |
| `partitionLabel` | string \| null | no | PKCS#11-era partition label — retired for the KMIP single-host shape; present only on legacy rows. Example: `"partition-1"`. |
| `port` | integer (int32) | yes | KMIP manager port. Example: `5696`. |
| `protocolVersion` | string | yes | KMIP protocol version negotiated (floor `1.4`). Example: `"1.4"`. |
| `status` | enum ("registered", "in_cluster", "deregistered") | yes | HYOK host lifecycle status. |


## Errors

| HTTP | Description |
|---|---|
| 401 | The request carries no authenticated caller. |
| 404 | No such host. |
| 500 | An internal error. Retry later. |

## Code samples

### cURL

```bash
curl -X GET 'https://<org>.api-<region>.k9o.io/@storefront/vault/hyok/hosts/<hostId>' \
  -H 'Authorization: Bearer $K9O_TOKEN'
```

### fetch

```javascript
const res = await fetch('https://<org>.api-<region>.k9o.io/@storefront/vault/hyok/hosts/<hostId>', {
  method: 'GET',
  headers: {
    'Authorization': `Bearer ${process.env.K9O_TOKEN}`
  },
});
const { data, meta } = await res.json();
```


Canonical page: https://docs.kilimanjaro.dev/api-playground/keys-secrets/get-host
