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.

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

List all your services

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

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

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

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

Read the transaction ledger

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.