---
title: "Get CVM details"
method: GET
path: "/api/v1/cvms/{cvm_id}"
tags: ["CVMs"]
---

# Get CVM details

`GET /api/v1/cvms/{cvm_id}`

Returns full CVM details including status, network info, and KMS configuration.

## Path parameters

- `cvm_id` string, required

## Response `200`

CVM details

- union
  - TeehouseApiRoutesCvmsManagementCvmBasicInfo — Detailed CVM information returned by GET /cvms/{cvm_id}.
    - `id` integer, required — Internal CVM database ID
    - `teepod_id` integer, nullable — Node ID (admin only)
    - `teepod` CvmNode
      - `id` integer, required
      - `name` string, required
      - `region_identifier` string, nullable
    - `name` string, required — RFC 1123 compliant CVM name
    - `status` string, required — Current status: running, stopped, starting, etc.
    - `in_progress` boolean — True if an operation is currently executing
    - `app_id` string, required — Unique application identifier
    - `vm_uuid` string, nullable — VM instance UUID on the node
    - `instance_id` string, nullable — Public instance identifier
    - `vcpu` integer, required — Allocated vCPU count
    - `memory` integer, required — Allocated memory in MB
    - `disk_size` integer, required — Allocated disk size in GB
    - `base_image` string, nullable — OS image name
    - `encrypted_env_pubkey` string, nullable — Public key for encrypting env vars
    - `listed` boolean — True if publicly listed
    - `project_id` string, hashid, nullable — A hashed identifier that maps to an internal database ID
    - `project_type` string, nullable — Project provision type
    - `instance_type` string, nullable — Instance type identifier
    - `public_sysinfo` boolean, nullable — Expose system info publicly
    - `public_logs` boolean, nullable — Expose logs publicly
    - `dapp_dashboard_url` string, nullable — DApp dashboard URL if applicable
    - `syslog_endpoint` string, nullable — Syslog streaming endpoint
    - `kms_info` KMSInfo — KMS instance information.
      - `id` string, hashid, required — Hashed KMS identifier (kms_xxxxx)
      - `slug` string, nullable — Human-readable KMS name
      - `url` string, required — KMS endpoint URL
      - `version` string, required — KMS software version
      - `chain_id` integer, nullable — Blockchain chain ID if onchain
      - `kms_contract_address` string, nullable — Smart contract address if onchain
      - `gateway_app_id` string, nullable — Gateway application ID
    - `contract_address` string, nullable — On-chain contract address
    - `deployer_address` string, nullable — Deployer wallet address
    - `scheduled_delete_at` string, date-time, nullable — Auto-delete timestamp (UTC)
    - `public_urls` CvmNetworkUrls[], nullable — Exposed service URLs
      - `app` string, required
      - `instance` string, required
    - `gateway_domain` string, nullable — Gateway base domain
  - CVMInfoDetail
    - `id` string, hashid, required — A hashed identifier that maps to an internal database ID
    - `name` string, required
    - `app_id` string, nullable
    - `vm_uuid` string, nullable
    - `instance_id` string, nullable
    - `resource` CVMResourceInfo, required
      - `instance_type` string, nullable
      - `vcpu` integer, nullable
      - `memory_in_gb` number, nullable
      - `disk_in_gb` integer, nullable
      - `gpus` integer, nullable
      - `compute_billing_price` string, decimal, nullable — A monetary value with precise decimal arithmetic
      - `billing_period` 'skip' | 'hourly' | 'monthly'
    - `node_info` NodeRef — Minimal node/teepod reference for embedding in responses.
      - `object_type` 'node' — Fixed value 'node'
      - `id` integer, nullable — Teepod numeric ID
      - `node_id` integer, nullable — Physical node numeric ID
      - `name` string, nullable — Node display name
      - `region` string, nullable — Region identifier
      - `device_id` string, nullable — Device ID
      - `ppid` string, nullable — PPID
      - `status` 'ONLINE' | 'OFFLINE' | 'MAINTENANCE'
      - `version` string, nullable — Teepod version
    - `os` CVMOSInfo
      - `name` string, nullable
      - `version` string, nullable
      - `is_dev` boolean, nullable
      - `os_image_hash` string, nullable
    - `kms_type` 'phala' | 'ethereum' | 'base' | 'legacy'
    - `kms_info` CVMKmsInfo
      - `chain_id` integer, nullable
      - `dstack_kms_address` string, nullable
      - `dstack_app_address` string, nullable
      - `deployer_address` string, nullable
      - `rpc_endpoint` string, nullable
      - `encrypted_env_pubkey` string, nullable
    - `status` string, required
    - `in_progress` boolean
    - `progress` CVMProgressInfo
      - `target` string, nullable
      - `started_at` string, date-time, nullable
      - `correlation_id` string, nullable
    - `compose_hash` string, nullable
    - `docker_compose_hash` string, nullable
    - `pre_launch_script_hash` string, nullable
    - `gateway` CVMGatewayInfo, required
      - `base_domain` string, nullable
      - `cname` string, nullable
    - `logs` CVMLogUrls
      - `serial` string, nullable
      - `stdout` string, nullable
      - `stderr` string, nullable
      - `container_log_base` string, nullable
    - `services` object[]
    - `endpoints` CvmNetworkUrls[], nullable
      - `app` string, required
      - `instance` string, required
    - `public_logs` boolean
    - `public_sysinfo` boolean
    - `public_tcbinfo` boolean
    - `gateway_enabled` boolean
    - `secure_time` boolean
    - `storage_fs` string
    - `workspace` WorkspaceRef — Minimal workspace reference for embedding in responses.
      - `object_type` 'workspace' — Fixed value 'workspace'
      - `id` string, hashid, required — Hashed workspace ID
      - `name` string, required — Workspace display name
      - `slug` string, nullable — URL-safe workspace identifier
      - `avatar_url` string, nullable — Workspace avatar URL from profile
    - `creator` UserRef — Minimal user reference for embedding in responses.
      - `object_type` 'user' — Fixed value 'user'
      - `id` string, hashid, nullable — A hashed identifier that maps to an internal database ID
      - `username` string, nullable — Display username
      - `avatar_url` string, nullable — Gravatar or OAuth provider avatar URL
    - `created_at` string, date-time, nullable
    - `deleted_at` string, date-time, nullable
    - `listed` boolean
    - `project_type` string, nullable
    - `compose_file` union
      - object
      - string

## Other responses

- `401` — Authentication required
- `403` — CVM not in workspace
- `404` — CVM not found
- `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/versions/83c6ae62e860/schema)