---
title: "Inspect KMS instance"
method: GET
path: "/api/v1/kms/{kms_id}/info"
tags: ["KMS"]
---

# Inspect KMS instance

`GET /api/v1/kms/{kms_id}/info`

Real-time inspection of a KMS instance. Queries KMS RPC, guest agent, associated Teepod VMMs, and on-chain contract data with cross-validation.

## Path parameters

- `kms_id` string, required

## Response `200`

Successful Response

- KmsInspectResponse
  - `id` string, required
  - `slug` string, nullable, required
  - `endpoint` string, required
  - `kms_type` string, required
  - `db_version` string, required
  - `rpc` KmsRpcInfo
    - `version` string, required — Real-time version from x-app-version header
    - `is_dev` boolean, required
    - `chain_id` integer, nullable
    - `kms_contract_address` string, nullable
    - `gateway_app_id` string, nullable
    - `bootstrap_info` BootstrapInfoOut, required
      - `k256_pubkey` string, required — K256 public key hex
      - `ca_pubkey` string, required — CA public key hex
      - `quote_length` integer, required — Quote byte length
      - `eventlog_length` integer, required — Eventlog byte length
    - `version_synced` boolean, required — Whether DB version matches real version
  - `rpc_error` string, nullable
  - `guest_agent` GuestAgentInfo
    - `device_id` string, required
    - `mr_aggregated` string, nullable
    - `os_image_hash` string, nullable
    - `instance_id` string, nullable
    - `app_id` string, nullable
    - `mr_key_provider` string, nullable
    - `compose_hash` string, nullable
  - `guest_agent_error` string, nullable
  - `teepods` TeepodInfo[]
    - `id` integer, required
    - `name` string, required
    - `teepod_version_db` string, nullable
    - `teepod_version_real` string, nullable
    - `kms_url` string, nullable — KMS URL configured in VMM
    - `kms_urls` string[]
    - `available_os_images` TeepodImageInfo[]
      - `name` string, required
      - `version` string, required
      - `is_dev` boolean, required
    - `error` string, nullable
  - `on_chain` OnChainInfo
    - `kms_info` OnChainKmsInfo
      - `k256_pubkey` string, required
      - `ca_pubkey` string, required
      - `quote_length` integer, required
      - `eventlog_length` integer, required
    - `gateway_app_id` string, nullable
    - `owner` string, nullable
    - `verification` OnChainVerification
      - `k256_pubkey_match` boolean, nullable — RPC vs chain k256_pubkey
      - `ca_pubkey_match` boolean, nullable — RPC vs chain ca_pubkey
      - `gateway_app_id_match` boolean, nullable — RPC vs chain gateway_app_id
      - `device_id_allowed` boolean, nullable — Guest agent device_id in whitelist
      - `os_image_allowed` boolean, nullable — Guest agent os_image_hash in whitelist
      - `mr_aggregated_allowed` boolean, nullable — Guest agent mr_aggregated in whitelist
    - `error` string, nullable

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/phala/apis/phala-cloud-api.md) · [All operations](https://skmtc.net/phala/apis/phala-cloud-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/phala/phala-cloud-api/revisions/83c6ae62e860/schema)