Skip to documentation
DocumentationAPI referenceGet server private networks
GETBearer token

Get server private networks

/api/v1/servers/:id/networks

Read up to 100 local port records for a current organization server and physical instance. Missing, deleted or transferred servers return 404. Invalid physical identity returns 409. Empty records do not prove isolation or stopped billing.

Before you call

Read-only local data. No supplier requests, billing or writes are performed. All capabilities are false; matching regions or providers does not prove compatibility or safe attachment.

Request example

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

Examples only. No requests are sent from this page.

Illustrative response
JSON
{
  "serverId": "507f1f77bcf86cd799439013",
  "ports": [],
  "nextCursor": null,
  "testOnly": false,
  "source": "local",
  "verification": "unknown",
  "capabilities": {
    "purchase": false,
    "attach": false,
    "disconnect": false,
    "remove": false,
    "reconnect": false,
    "cancelAddon": false,
    "renew": false,
    "resize": false,
    "delete": false,
    "blockedReason": "Private network supplier actions are not verified. Billing requires verified supplier support; local snapshots do not establish compatibility or safe attachment."
  }
}

Parameters

idPath · Required

string

Current organization server ID: 24 hexadecimal characters. Deleted or transferred servers are not accessible.

afterQuery · Optional

string

Optional 24-hex-character port cursor from nextCursor. Returns port IDs greater than this cursor, up to 100 rows; null means no next page.

Response

HTTP status 200

Read up to 100 local port records for a current organization server and physical instance. Missing, deleted or transferred servers return 404. Invalid physical identity returns 409. Empty records do not prove isolation or stopped billing.

serverIdstring

Current organization server ID: 24 hexadecimal characters. Deleted or transferred servers are not accessible.

testOnlyboolean

True marks a test context only, which can include real purchased servers. It does not prove simulation or bypass billing or safety checks.

portsobject[]

Read up to 100 local port records for a current organization server and physical instance. Missing, deleted or transferred servers return 404. Invalid physical identity returns 409. Empty records do not prove isolation or stopped billing.

ports[].idstring

Platform identifier, not a supplier identifier.

ports[].slotinteger

Stored local snapshot value, not verified live supplier state.

ports[].serverIdstring

Current organization server ID: 24 hexadecimal characters. Deleted or transferred servers are not accessible.

ports[].activeboolean

Stored local snapshot value, not verified live supplier state.

ports[].reservationStatestring

Stored local snapshot value, not verified live supplier state.

ports[].connectionStatestring

Connection and IP data require a matching owned network and a valid non-future check timestamp. Otherwise connectionState is unknown and checkedAt/privateIps are null. These are local snapshots only.

ports[].privateIpsstring[] | null

Connection and IP data require a matching owned network and a valid non-future check timestamp. Otherwise connectionState is unknown and checkedAt/privateIps are null. These are local snapshots only.

ports[].checkedAtstring | null

Connection and IP data require a matching owned network and a valid non-future check timestamp. Otherwise connectionState is unknown and checkedAt/privateIps are null. These are local snapshots only.

ports[].versioninteger

Stored local snapshot value, not verified live supplier state.

ports[].testOnlyboolean

True marks a test context only, which can include real purchased servers. It does not prove simulation or bypass billing or safety checks.

ports[].networkobject | null

Owned network snapshot using the list_networks network fields, or null when the network is unavailable or its test context differs from the server or port.

ports[].network.cidrstring | null

Stored private network CIDR, or null when not observed.

ports[].network.boundServersinteger | null

Count of active bindings to current owned physical servers; null when the count is inconsistent.

ports[].network.occupiedPortsinteger | null

Count of active local reservations including pending and releasing slots; null when occupancy is inconsistent.

ports[].network.idstring

Platform identifier, not a supplier identifier.

ports[].network.providerstring

Stored local snapshot value, not verified live supplier state.

ports[].network.namestring

Stored local snapshot value, not verified live supplier state.

ports[].network.regionstring

Stored local snapshot value, not verified live supplier state.

ports[].network.dataCenterstring | null

Stored local snapshot value, not verified live supplier state.

ports[].network.capacityinteger

Stored local snapshot value, not verified live supplier state.

ports[].network.statestring

Stored local snapshot value, not verified live supplier state.

ports[].network.versioninteger

Stored local snapshot value, not verified live supplier state.

ports[].network.monthlyPricestring

Integer USD cents as a string, not dollars; a listed price does not enable payment.

ports[].network.serviceFromstring (ISO 8601) | null

Service starts only after verified purchase completion, or null when unknown.

ports[].network.serviceUntilstring (ISO 8601) | null

Platform paid service cutoff, independent of supplier paid dates; null when unknown.

ports[].network.autoRenewboolean

Renewal preference only; it does not prove payment or extension.

ports[].network.accessStatestring

Stored local network access state: active, stopping, stopped, restoring or unknown. It does not verify current supplier connectivity.

ports[].network.currency"USD"

Fixed currency USD, price unit cent and billing period month where present.

ports[].network.priceUnit"cent"

Fixed currency USD, price unit cent and billing period month where present.

ports[].network.checkedAtstring | null

Snapshot check time in ISO 8601, or null when unknown. A timestamp is not a live verification.

ports[].network.testOnlyboolean

True marks a test context only, which can include real purchased servers. It does not prove simulation or bypass billing or safety checks.

ports[].network.source"local"

Always local; no live supplier request is made.

ports[].network.verification"unknown" | "snapshot"

snapshot when checkedAt exists, otherwise unknown. Neither value verifies current supplier state.

ports[].network.capabilitiesobject

All nine flags are false: purchase, attach, disconnect, remove, reconnect, cancelAddon, renew, resize and delete. blockedReason explains that supplier support is unverified and billing is unavailable until verified; snapshots do not establish compatibility or safe attachment.

nextCursorstring | null

Optional 24-hex-character port cursor from nextCursor. Returns port IDs greater than this cursor, up to 100 rows; null means no next page.

source"local"

Always local; no live supplier request is made.

verification"unknown"

Always unknown; an empty local result is not proof of supplier absence.

capabilitiesobject

All nine flags are false: purchase, attach, disconnect, remove, reconnect, cancelAddon, renew, resize and delete. blockedReason explains that supplier support is unverified and billing is unavailable until verified; snapshots do not establish compatibility or safe attachment.