GET
/vault/hyok/hosts/{host_id}Get Host
Returns one HYOK host.
Needs ORG_ADMIN.
Parameters
| orgId * | query | The organisation's id. |
| host_id * | path | The host's id: |
Responses
| HTTP | K9O Code | Description |
|---|---|---|
| 200 | The host. | |
| 401 | The request carries no authenticated caller. | |
| 404 | No such host. | |
| 500 | An internal error. Retry later. |
Response body (200)
| caRef * | string | Secret-store handle for the customer's server trust-anchor CA. Example: "secret://hyok/kmip-server-ca" |
| clientCertRef * | string | Secret-store handle for the platform mTLS client identity. Example: "secret://hyok/kmip-client-identity" |
| clusterId | string | null | Cluster identifier; non-null iff Example: "hyokcluster_0b6f2c1e-3d4a-4b5c-8d9e-0f1a2b3c4d5e" |
| createdAt * | string <date-time> | Host registration timestamp. Example: "2026-11-01T08:00:00.000Z" |
| hostname * | string | KMIP manager hostname (matches the server-cert SAN). Example: "kmip.acme.example" |
| hsmModel * | "thales-luna" | "entrust-nshield" | "aws-cloudhsm" | HSM model variants supported in the HYOK host registry. |
| id * | string | Host identifier — UUID prefixed Example: "hyokhost_9e8d7c6b-5a49-4f3e-8d2c-1b0a9f8e7d6c" |
| label * | string | Human-readable label (e.g., Example: "luna-prod-01" |
| orgId * | string | Owning org. Example: "org_8kP3wQ9zLm2X" |
| partitionLabel | string | null | PKCS#11-era partition label — retired for the KMIP single-host shape; present only on legacy rows. Example: "partition-1" |
| port * | integer <int32> | KMIP manager port. Example: 5696 |
| protocolVersion * | string | KMIP protocol version negotiated (floor Example: "1.4" |
| status * | "registered" | "in_cluster" | "deregistered" | HYOK host lifecycle status. |
cURL
curl -X GET 'https://<org>.api-<region>.k9o.io/@storefront/vault/hyok/hosts/<hostId>' \
-H 'Authorization: Bearer $K9O_TOKEN'Showing example in cURL
Response example (200)
{
"caRef": "secret://hyok/kmip-server-ca",
"clientCertRef": "secret://hyok/kmip-client-identity",
"clusterId": "hyokcluster_0b6f2c1e-3d4a-4b5c-8d9e-0f1a2b3c4d5e",
"createdAt": "2026-11-01T08:00:00.000Z",
"hostname": "kmip.acme.example",
"hsmModel": "thales-luna",
"id": "hyokhost_9e8d7c6b-5a49-4f3e-8d2c-1b0a9f8e7d6c",
"label": "luna-prod-01",
"orgId": "org_8kP3wQ9zLm2X",
"partitionLabel": "partition-1",
"port": 5696,
"protocolVersion": "1.4",
"status": "registered"
}