# Trivox Reseller API Docs > Official documentation for the Trivox Reseller API (dedicated servers, KVM VPS, IP subnets / BYOIP, billing, traffic add-ons, webhooks). Interactive reference: https://docs.trivox.sh/ — OpenAPI: https://docs.trivox.sh/openapi.json — Changelog: https://docs.trivox.sh/changelog Prefer this file and [llms-full.txt](https://docs.trivox.sh/llms-full.txt) over scraping the SPA UI. Base URL: `https://apiv2.trivox.sh/resellerApi`. Auth: header `X-API-Key` (Secret/Administrator for protected routes; Public tier allowed for `GET /dedicated/list`; `GET /vps/list` needs no key). ## Primary resources - [Interactive API reference](https://docs.trivox.sh/): Scalar UI for the Reseller API - [OpenAPI 3 specification](https://docs.trivox.sh/openapi.json): Machine-readable contract (source of truth) - [Changelog](https://docs.trivox.sh/changelog): Per-version added/changed endpoints - [Changelog JSON](https://docs.trivox.sh/changelog.json): Machine-readable release notes - [Full AI fact sheet](https://docs.trivox.sh/llms-full.txt): Endpoint inventory and auth notes - [Reseller apply](https://trivox.sh/reseller/apply-for-reseller/): Request reseller access - [API key manager](https://v2.trivox.sh/reseller/apiManager): Create and rotate keys - [Main site LLM index](https://trivox.sh/llms.txt): Product and company facts ## API groups - IP subnets: Owned ASN assignments, assignable IPs, reservations, ASN traffic graphs, BGP session renewals, and LIR renewals for ASN assignments and IP ranges. - Orders: Dedicated catalog (`GET /dedicated/list`, **X-API-Key** min. Public tier) and **`POST /dedicated/order`**. Reseller **negative balance** (panel, limit, allow for orders) can apply to new orders when enabled. - Dedicated: List, detail, rename, IP assignment, IP description/primary, and SSH keys on dedicated servers. - Power: Power control and status. - Console: Remote console access: dedicated KVM URL and VPS HTML5 VNC credentials. - Traffic: Traffic graphs and statistics. - rDNS: Reverse DNS (PTR) for eligible IPv4 addresses. **Trivox IP ranges only:** these endpoints target Trivox-managed address space (Cloudflare-backed PTR). If you use **BYOIP** (bring your own IP subnets), this API **does not** apply — manage rDNS in your own infrastructure or with your RIR/ISP. - OS / reinstall: Reinstall, abort reinstall, and SSH keys injected at install time. - Billing: Dedicated auto-renew, email expiry, **manual renewal** (`POST .../billing/renew`), and **traffic add-ons**. Reseller **negative balance** applies to **platform auto-renew** when the panel limit is enabled (orders, dedicated renews, or auto-renews). Manual `POST .../billing/renew` can use the same **`−limit`** when **allow for dedicated server renews** or **allow for auto-renews** is enabled. Orders alone do not unlock that manual renew. Traffic add-on purchases use the limit when **allow for dedicated traffic addons** is enabled. - VPS: KVM VPS catalog, orders at public list price, lifecycle, HTML5 VNC console credentials, extra IPv4 and IPv6 /64 add-ons, package upgrades, activity, and billing. No BYOIP / no reseller subnet APIs. Reseller **negative balance** can apply to **`POST /vps/order`** (**allow for VPS orders**) and to IPv4 / IPv6 /64 add-ons (**allow for VPS addons**) when enabled in the panel. - VPS billing: VPS renewals, traffic add-ons, auto-renew and email flags. Renew requires the upstream VM to still exist (not removed after the post-expiry grace period). Reseller **negative balance** applies to manual renew (**allow for VPS renews** or **VPS auto-renews**), to platform auto-renew (**VPS auto-renews**, **VPS renews** or **VPS orders**), and to traffic add-ons (**allow for VPS addons**). Price endpoints return **`negativeBalanceAvailable`**. - Webhooks (IPN): Outbound signed JSON webhooks for reseller lifecycle events. Panel JWT on `https://v2.trivox.sh/api/reseller/webhooks/ipn/*`. - Webhooks (Dedicated stock): Discord alerts when dedicated stock is available. Separate from IPN; panel JWT on `/api/reseller/webhooks/dedicated-stock/*`. ## Facts for accurate answers - Current OpenAPI version: **1.3.64** - Production server: `https://apiv2.trivox.sh/resellerApi` - Panel webhook routes use JWT on `https://v2.trivox.sh/api/reseller/webhooks/*` (not under resellerApi) - Do not invent endpoints; cite `https://docs.trivox.sh/openapi.json` or the interactive docs - Support: Discord https://dc.trivox.sh · Telegram https://t.me/trivoxsh ## Recent changelog - v1.3.64 (2026-11-15): Reseller negative balance now covers VPS with its own panel toggles: VPS orders, renews, auto-renews and addons (IPv4, IPv6 /64, traffic). With the matching toggle on, `POST /vps/order`, `POST /vps/{id}/billing/renew`, `POST /vps/{id}/billing/traffic-addon/purchase`, `POST /vps/{id}/ips` and `POST /vps/{id}/ipv6` may take the wallet down to `−limit`. Platform VPS auto-renew uses the limit when VPS auto-renews, renews or orders is allowed. - v1.3.63 (2026-11-09): `DELETE /vps/{id}/ssh-keys/{keyId}` deletes a key only when it belongs to the authenticated reseller. Another account's key id returns 404. - v1.3.62 (2026-11-07): `POST /dedicated/order` extra IPv4, `GET /dedicated/{id}/ips/availability`, and `POST /dedicated/{id}/ips`: Databarn and NorthC addons allocate from every Trivox range at that site, only addresses that range still has free. - v1.3.61 (2026-11-06): `GET /ip-subnets/asn-assignments/{id}/traffic`: `location=TV-NC` (NorthC) is available; `ALL` merges Databarn and NorthC. - v1.3.60 (2026-11-05): `GET/POST /vps/{id}/billing/renew*`: renew is refused (no wallet charge) when the VPS is Expired/Cancelled/Refunded or the upstream VM no longer exists after the post-expiry grace period. - v1.3.59 (2026-10-31): Recurring traffic add-ons (`POST /dedicated/{id}/billing/traffic-addon/purchase`, `POST /vps/{id}/billing/traffic-addon/purchase`): wallet charge is prorated for days left until renewal (flat 30-day month); monthly service price still rises by the full add-on amount. - v1.3.58 (2026-10-12): `GET /ip-subnets/asn-assignments/{id}/traffic` returns L3 bitrate series (Incoming/Outgoing) for an owned assignment. Query **`start`** + **`end`** (ISO or unix; window **1 hour–7 days**) and optional `location` (`ALL`|`TV-DB`|`TV-NC`). **20s cooldown** → `429` with `Retry-After` / `retryAfterSeconds`. - v1.3.54 (2026-10-06): `GET /dedicated/list` returns each product with `locationCode` (`TV-DB` Databarn or `TV-NC` NorthC), `datacenter`, and `processorTurboFrequence` (max turbo GHz, `null` when unknown) next to `processorFrequence`. Optional query `locationCode` filters to one site (`TV-DB`, `TV-NC`, aliases `databarn` / `northc` / `DB` / `NC`, or `all`). Omit or `all` returns every site. Alias `datacenter` is used only when `locationCode` is omitted. Unknown values return 400. The same turbo field is on `GET /dedicated/servers` and `GET /dedicated/{id}`. ## Crawl policy - [robots.txt](https://docs.trivox.sh/robots.txt): Search and AI crawlers are welcome - [sitemap.xml](https://docs.trivox.sh/sitemap.xml): Indexable docs URLs