ovahub
Skip to documentation
DocumentationAPI referenceList orders
GETBearer token

List orders

/api/v1/orders

Read up to 100 recent organization orders. Payment does not mean the server has been delivered.

Request example

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

Examples only. No requests are sent from this page.

Illustrative response
JSON
[]

Parameters

No parameters.

Response

HTTP status 200

Return an array of up to 100 recent orders in the current organization.

[]array

The root response is an array, not an orders wrapper.

[]._idstring (ObjectId)

Order identifier.

[].assetstring ('USD' | 'xTOVA')

Stored payment asset.

[].amountstring

Integer USD cents or integer xTOVA units.

[].planIdstring

Purchased plan identifier.

[].regionstring

Purchased region code.

[].daysnumber

Purchased billing duration in days.

[].hostnamestring

Server hostname.

[].namestring (optional)

User-assigned display name, when present.

[].osstring

Requested operating system identifier.

[].statusstring ('pending' | 'provisioning' | 'completed' | 'failed' | 'refunded')

Order fulfillment status.

[].providerServerIdstring | null

Supplier instance identifier, when known.

[].failureReasonstring | null

Recorded failure reason, if any.

[].createdAtstring (ISO 8601)

Order creation time.

[].updatedAtstring (ISO 8601)

Order last-update time.

[].paymentTxHashstring (optional)

Recorded blockchain transaction hash.

[].autoRenewboolean

Auto-renew preference recorded on the original order.

Related

Requests & errorsAuthenticationMCP · list_my_orders