---
title: "Get a server · API | Rdp.Vision"
description: "GET /servers/{id}: One server with its login. password is only included when the key also has the credentials scope. While a new or reinstalled server sets up, "
url: https://rdp.vision/docs/api/servers/get
---

Open in AI

[ChatGPT](https://chatgpt.com/?q=Read%20https%3A%2F%2Frdp.vision%2Fdocs%2Fapi%2Fservers%2Fget.md%20and%20help%20me%20use%20the%20Rdp.Vision%20API.)[Claude](https://claude.ai/new?q=Read%20https%3A%2F%2Frdp.vision%2Fdocs%2Fapi%2Fservers%2Fget.md%20and%20help%20me%20use%20the%20Rdp.Vision%20API.)

Servers

# Get a server

One server with its login. password is only included when the key also has the credentials scope. While a new or reinstalled server sets up, setup shows how far it is; power actions are refused until setup.unlocks\_at.

GET`/servers/{id}`

## Authorization

`Authorization`header required

`Bearer rv_…`, a key with the `read` scope. [About keys](https://rdp.vision/docs/api/authentication)

## Path parameters

`id`string (uuid) required

The server id from List servers.

## Response

`id`string (uuid)

The server id.

`hostname`string | null

The name you gave it.

`ip_address`string | null

Public IPv4 address, null while it’s being created.

`status`string

provisioning, reinstalling, moving, running, stopped, suspended, expired or deleted.

`distro_name`string | null

Operating system, e.g. Windows Server 2022.

`plan_id`integer

The plan, see List plans.

`region_id`integer

The location, see List locations.

`distro_id`integer

The operating system, see List operating systems.

`sell_price`string (decimal)

Monthly price in USD.

`duration_months`integer

The term it was ordered for.

`expiry_date`string (datetime) | null

Paid until.

`auto_renew`boolean

Renews from the balance before it expires.

`created_at`string (datetime)

When it was ordered.

`suspended_at`string (datetime) | null

Set while the server is suspended.

`suspend_reason`string | null

Why, when it is.

`username`string | null

Administrator on Windows, root on Linux.

`password`string | null

Needs the credentials scope.

`setup`object | null

stage (creating, installing, ready), started\_at, unlocks\_at, ready\_at, reinstall.

## Status codes

- 200 | Success.
- 401 | No key, a wrong key, or a revoked or expired one.
- 404 | No such server or order on this account.
- 429 | More than 120 requests a minute with one key, or too many wrong keys from one address.

Request

curl "https://rdp.vision/api/v1/servers/3f6c2a8e-91d4-4b7a-a5e2-7c0d9b1f4e36" \\
  -H "Authorization: Bearer $RDPVISION\_KEY"

Response

{
  "id": "3f6c2a8e-91d4-4b7a-a5e2-7c0d9b1f4e36",
  "hostname": "trading-01",
  "ip\_address": "203.0.113.18",
  "status": "running",
  "distro\_name": "Windows Server 2022",
  "plan\_id": 1,
  "region\_id": 10,
  "distro\_id": 2,
  "sell\_price": "13.00",
  "duration\_months": 1,
  "expiry\_date": "2026-12-12T18:20:57Z",
  "auto\_renew": true,
  "created\_at": "2026-11-12T18:20:56Z",
  "suspended\_at": null,
  "suspend\_reason": null,
  "username": "Administrator",
  "password": "k8#Qm2!vXr9p",
  "setup": null
}