Reseller & API

List services, get a single service, and check your balance

Use GET /services to list everything you have provisioned, GET /services/{id} for one service, GET /account for your credit balance, and GET /account/transactions for the ledger.

list servicesbalanceaccounttransactionsreconcile

These read endpoints are how you build a dashboard, reconcile billing, and monitor your prepaid balance.

List all your services

bash

curl https://control.victuscloud.com/api/reseller/v1/services \
  -H "Authorization: Bearer $VICTUS_KEY"

# Filter with query params, e.g. by category or status
curl "https://control.victuscloud.com/api/reseller/v1/services?category=vps&status=running" \
  -H "Authorization: Bearer $VICTUS_KEY"

The response is a data array of service summaries (id, category, label, status, plan code, region). Large lists are paginated — follow the pagination fields in the response.

Get a single service

bash

curl https://control.victuscloud.com/api/reseller/v1/services/svc_8fj2k \
  -H "Authorization: Bearer $VICTUS_KEY"

A single service includes its full detail: current status, connection info (IP/port or domain), specs, plan code, region, and next renewal date.

Check your balance

bash

curl https://control.victuscloud.com/api/reseller/v1/account \
  -H "Authorization: Bearer $VICTUS_KEY"

json

{
  "data": {
    "id": "acct_x91",
    "credits": 128.5,
    "currency": "credits",
    "active_services": 14
  }
}

Read the transaction ledger

bash

curl https://control.victuscloud.com/api/reseller/v1/account/transactions \
  -H "Authorization: Bearer $VICTUS_KEY"

Transactions cover top-ups (credit) and service charges/renewals (debit), each with an amount, timestamp and the related service id — perfect for reconciling against what you charged your own customers.

Automate a low-balance alert

Poll GET /account on a schedule (well within 240 req/min) and alert yourself when credits drops below a threshold, so customer services never lapse for lack of funds.

Related in Reseller & API

Reseller API overview (sell VPS, game, bot and app hosting under your brand)What the Victus Reseller API is, what you can sell with it, and how the prepaid credit model works so you can build your own storefront on top of Victus infrastructure.Get an API key and understand the prepaid credit modelMint a reseller API key (rslr_...) from the Reseller API page in the Victus panel, store it safely, and top up the prepaid credit balance the API spends.Authentication and base URLThe Reseller API base URL, how to send your rslr_ bearer token, required headers, and a quick authenticated request to confirm your key works.Response format, errors, rate limits and scopesThe standard success {data} and error {errors:[{code,status,detail}]} envelopes, common HTTP status codes, the 240 req/min rate limit, and how key scopes restrict access.List the catalog, plans and regionsRead the available product categories, plans and pricing with GET /catalog, drill into a specific plan code, and list deployment regions with GET /regions.Provision a service (VPS, game, bot and app examples)Create services with POST /services for every category — full curl examples for a VPS, a Minecraft game server, a Discord bot and an app, plus how to poll until it is ready.Manage a service (power, console, usage, lifecycle, backups)Control a provisioned service: power signals, console access, usage stats, suspend/unsuspend, reinstall, resize, reset-password, backups and termination.Webhooks (events and X-Victus-Signature HMAC verification)Register a webhook endpoint with PUT /webhooks, receive service and billing events, and verify every delivery with the X-Victus-Signature HMAC header.