ovahub
Skip to documentation
DocumentationAPI referenceCheck private network for a new server
GETBearer token

Check private network for a new server

/api/v1/networks/:id/order-check

Compare an owned network with a local Contabo plan and count active local slots. Missing networks or plans return 404. This is not a quote, reservation or compatibility guarantee.

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/507f1f77bcf86cd799439012/order-check?planId=V153&region=EU" \
  -H "Authorization: Bearer $TOVAHUB_TOKEN"

Examples only. No requests are sent from this page.

Illustrative response
JSON
{
  "networkId": "507f1f77bcf86cd799439011",
  "source": "local",
  "regionMatch": true,
  "providerMatch": true,
  "eligible": false,
  "testOnly": true,
  "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."
  },
  "blockedReason": "Private network supplier actions are not verified. Billing requires verified supplier support; local snapshots do not establish compatibility or safe attachment.",
  "planId": "V153",
  "region": "EU",
  "networkState": "ready",
  "verification": "unknown",
  "capacity": {
    "total": 5,
    "localOccupied": 2,
    "localRemaining": 3,
    "networkVersion": 1,
    "verification": "snapshot"
  },
  "compatibility": "unknown",
  "supplierCost": "unknown",
  "reserved": false
}

Parameters

idPath · Required

string

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

planIdQuery · Required

string

Local Contabo plan ID: 1–100 letters, digits, underscores or hyphens. No supplier catalog request is made.

regionQuery · Required

string

Local plan region: 2–40 letters, digits, underscores or hyphens. The exact provider, plan and region must exist locally.

Response

HTTP status 200

Compare an owned network with a local Contabo plan and count active local slots. Missing networks or plans return 404. This is not a quote, reservation or compatibility guarantee.

networkIdstring

Platform identifier, not a supplier identifier.

planIdstring

Local Contabo plan ID: 1–100 letters, digits, underscores or hyphens. No supplier catalog request is made.

regionstring

Local plan region: 2–40 letters, digits, underscores or hyphens. The exact provider, plan and region must exist locally.

source"local"

Always local; no live supplier request is made.

regionMatchboolean

Local comparison only; true does not establish compatibility or safe attachment.

providerMatchboolean

Local comparison only; true does not establish compatibility or safe attachment.

networkStatestring

Stored local snapshot value, not verified live supplier state.

verification"unknown"

Always unknown; product and data-center compatibility, supplier capacity, add-on requirements and cost have not been verified.

capacityobject

Local capacity only: total is a known directory size or null. Counts include all active reserved, assigned and releasing slots, including disconnected slots. Corruption, overflow or a changed network version makes both counts null. A snapshot reserves nothing and does not prove supplier capacity.

capacity.totalinteger | null

Local capacity only: total is a known directory size or null. Counts include all active reserved, assigned and releasing slots, including disconnected slots. Corruption, overflow or a changed network version makes both counts null. A snapshot reserves nothing and does not prove supplier capacity.

capacity.localOccupiedinteger | null

Local capacity only: total is a known directory size or null. Counts include all active reserved, assigned and releasing slots, including disconnected slots. Corruption, overflow or a changed network version makes both counts null. A snapshot reserves nothing and does not prove supplier capacity.

capacity.localRemaininginteger | null

Local capacity only: total is a known directory size or null. Counts include all active reserved, assigned and releasing slots, including disconnected slots. Corruption, overflow or a changed network version makes both counts null. A snapshot reserves nothing and does not prove supplier capacity.

capacity.networkVersioninteger | null

Local capacity only: total is a known directory size or null. Counts include all active reserved, assigned and releasing slots, including disconnected slots. Corruption, overflow or a changed network version makes both counts null. A snapshot reserves nothing and does not prove supplier capacity.

capacity.verification"snapshot" | "unknown"

Local capacity only: total is a known directory size or null. Counts include all active reserved, assigned and releasing slots, including disconnected slots. Corruption, overflow or a changed network version makes both counts null. A snapshot reserves nothing and does not prove supplier capacity.

compatibility"unknown"

Always unknown; product and data-center compatibility, supplier capacity, add-on requirements and cost have not been verified.

supplierCost"unknown"

Always unknown; product and data-center compatibility, supplier capacity, add-on requirements and cost have not been verified.

eligiblefalse

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.

reservedfalse

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.

testOnlyboolean

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

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.

blockedReasonstring

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.

Related

Requests & errorsAuthenticationMCP · check_network_order