---
title: "Get VNC status"
method: POST
path: "/kvm/v2/get/vnc/status"
tags: ["VNC Management"]
---

# Get VNC status

`POST /kvm/v2/get/vnc/status`

This endpoint retrieves the current status of the VNC session for a specified KVM VPS.  
The `api_host` parameter, obtained from the **"Create AUTH-session"** response,  
is dynamically set in the URL.  
Provide the `signature`, `kvm_id`, and `valid_until` parameters to get the VNC session status.

## Response `200`

VNC status retrieved successfully.

- InlineResponse20016
  - `status` string — The status of the operation.
  - `vnc_status` string — The current VNC status (e.g., enabled, disabled).
  - `novnc_port` integer — The noVNC port for web-based access.
  - `vnc_port` string — The port used for VNC connections.
  - `vnc_host` string — The VNC host address.

## Other responses

- `400` — Bad Request - Invalid or missing parameters in the request.
- `401` — Unauthorized - Invalid or expired session signature provided.
- `403` — Forbidden - Access to the requested resource is denied.
- `500` — Internal Server Error - An unexpected issue occurred on the server.

---

[API](https://skmtc.net/edisglobal/apis/edis-global-management-api.md) · [All operations](https://skmtc.net/edisglobal/apis/edis-global-management-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/edisglobal/edis-global-management-api/versions/223263c91ac0/schema)