Skip to documentation
GETBearer token

List servers

/api/v1/servers

Read organization servers, region, plan, status, auto-renew preference and expiry. Credentials are not included.

Request example

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

Examples only. No requests are sent from this page.

Illustrative response
JSON
{
  "servers": [],
  "dashboard": "https://tovahub.com/dashboard/servers"
}

Parameters

No parameters.

Response

HTTP status 200

List current non-deleted organization servers without returning login credentials.

serversarray

Current server summaries.

servers[].idstring (ObjectId)

Local platform server identifier.

servers[].hostnamestring | null

Saved hostname.

servers[].planstring

Plan identifier; this response uses plan, not planId.

servers[].regionstring

Region code.

servers[].statusstring

Normalized saved server status.

servers[].autoRenewboolean

Saved site auto-renew preference.

servers[].expiresAtstring (ISO 8601) | null

Saved paid-through date.

servers[].testOnlyboolean

Whether this is isolated test inventory.

servers[].testUntilstring (ISO 8601) | null

Test expiry, if any.

servers[].updatedAtstring (ISO 8601)

Last server-record update.

servers[].statusCheckedAtstring (ISO 8601) | null

Last status observation timestamp.

dashboardstring (URL)

Dashboard server-list URL.