ovahub
Skip to documentation
DocumentationAPI referenceList private networks
GETBearer token

List private networks

/api/v1/networks

Read up to 100 local network snapshots owned by the current organization, sorted by ID. An empty page does not verify supplier absence.

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/networks" \
  -H "Authorization: Bearer $TOVAHUB_TOKEN"

Examples only. No requests are sent from this page.

Illustrative response
JSON
{
  "networks": [],
  "nextCursor": null,
  "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

afterQuery · Optional

string

Optional 24-hex-character cursor from nextCursor (network list) or portsNextCursor (network detail). Returns IDs greater than this cursor, up to 100 rows; null means no next page.

Response

HTTP status 200

Read up to 100 local network snapshots owned by the current organization, sorted by ID. An empty page does not verify supplier absence.

networksobject[]

Read up to 100 local network snapshots owned by the current organization, sorted by ID. An empty page does not verify supplier absence.

networks[].idstring

Platform identifier, not a supplier identifier.

networks[].providerstring

Stored local snapshot value, not verified live supplier state.

networks[].namestring

Stored local snapshot value, not verified live supplier state.

networks[].regionstring

Stored local snapshot value, not verified live supplier state.

networks[].dataCenterstring | null

Stored local snapshot value, not verified live supplier state.

networks[].cidrstring | null

Stored private network CIDR, or null when not observed.

networks[].boundServersinteger | null

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

networks[].occupiedPortsinteger | null

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

networks[].capacityinteger

Stored local snapshot value, not verified live supplier state.

networks[].statestring

Stored local snapshot value, not verified live supplier state.

networks[].versioninteger

Stored local snapshot value, not verified live supplier state.

networks[].monthlyPricestring

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

networks[].serviceFromstring (ISO 8601) | null

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

networks[].serviceUntilstring (ISO 8601) | null

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

networks[].autoRenewboolean

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

networks[].accessStatestring

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

networks[].currency"USD"

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

networks[].priceUnit"cent"

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

networks[].checkedAtstring | null

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

networks[].testOnlyboolean

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

networks[].source"local"

Always local; no live supplier request is made.

networks[].verification"unknown" | "snapshot"

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

networks[].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 cursor from nextCursor (network list) or portsNextCursor (network detail). Returns 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.

Related

Requests & errorsAuthenticationMCP · list_networks