Skip to documentation
GETNo authentication

List plans

/api/v1/plans

Read the current plan catalog, regions, prices and billing terms. Catalog availability is not a stock reservation.

Request example

cURL
curl "https://tovahub.com/api/v1/plans"

Examples only. No requests are sent from this page.

Parameters

regionQuery · Optional

string

Optional region code from the regions endpoint.

Response

HTTP status 200

Read the current public VPS catalog and decimal-dollar prices.

providerstring ('contabo')

Current provider identifier.

ordersEnabledboolean

Whether catalog prices and platform ordering are enabled.

stockIsReservationboolean (false)

Displayed stock does not reserve capacity.

regionsarray

Configured public regions.

regions[].codestring

Region code.

regions[].labelstring

Region display label.

regions[].availableboolean

Listed availability; not a reservation.

plansarray

Plans optionally filtered by region.

plans[].idstring

Plan identifier.

plans[].namestring

Plan display name.

plans[].familystring

Plan family.

plans[].regionstring

Region code.

plans[].cpunumber

CPU count.

plans[].memoryMbnumber

Memory in MB.

plans[].storageGbnumber

Storage in GB.

plans[].storageTypestring

Storage type.

plans[].bandwidthstring (optional)

Advertised bandwidth label.

plans[].inStockboolean (optional)

Listed stock signal, when known.

plans[].stockFreshboolean

Whether the last stock signal is still within its freshness window.

plans[].stockExpiresAtstring (date-time, optional)

UTC expiry time for the stock signal. Missing or expired freshness must not enable a new order.

plans[].monthlyFromUsdstring

Decimal USD monthly-from price; unlike payment amounts, this is not integer cents.

plans[].termsarray

Currently listed billing terms.

plans[].terms[].monthsnumber

Billing term in months.

plans[].terms[].totalUsdstring

Decimal USD total for the term.

pricingPagestring (URL)

Public pricing-page URL.