Skip to documentation
DocumentationAPI referenceGet server details
GETBearer token

Get server details

/api/v1/servers/:id

Read server details without login credentials. The returned instanceId is a supplier ID, not the platform ID used in API paths.

Request example

cURL
curl "https://tovahub.com/api/v1/servers/507f1f77bcf86cd799439012" \
  -H "Authorization: Bearer $TOVAHUB_TOKEN"

Examples only. No requests are sent from this page.

Parameters

idPath · Required

string

Resource ID: 24 hexadecimal characters. Use the platform ID returned by the matching list endpoint, not a supplier instance ID.

Response

HTTP status 200

Read local server details without returning login credentials.

testOnlyboolean

Whether this server is isolated test inventory.

testUntilstring (ISO 8601) | null

Test inventory expiry, if any.

supplierPaidThroughstring (ISO 8601) | null

The server's saved expiresAt value; returned under this historical field name.

instanceIdstring

Supplier instance identifier, not the platform server ObjectId.

namestring

Saved hostname, or an empty string.

statusstring

Saved server status.

previewboolean

Whether the server is a read-only preview.

regionstring

Region label, falling back to its code.

dataCenterstring

Currently an em-dash placeholder.

productstring

Saved product label, falling back to an em dash.

cpunumber

Saved CPU count, or zero.

memoryMbnumber

Saved memory in MB, or zero.

diskMbnumber

Saved disk capacity in MB, or zero.

operatingSystemstring

Saved OS label or identifier, falling back to an em dash.

imageIdnull

Not populated by the current local-details reader.

ipv4string | null

Saved IPv4 address, if any.

ipv6string | null

Saved IPv6 address, if any.

macAddressstring

Saved MAC address, or an empty string.

createdAtstring (ISO 8601) | null

Saved purchase creation time, if any.

additionalIpsnull

Not populated by the current local-details reader.

privateNetworksnull

Not populated by the current local-details reader.

firewallsnull

Read firewall attachments through get_server_resources.