CDNShark Documentation

Reseller API Reference

Complete endpoint list for the Reseller API. Base URL: /api/reseller. All requests require Authorization: Bearer YOUR_RESELLER_TOKEN.

Catalog

Method	Endpoint	Ability	Description
GET	/api/reseller/plans	catalog:read	Plans with wholesale pricing. Filter with ?type=
GET	/api/reseller/plans/{id}	catalog:read	One plan, with its spec
GET	/api/reseller/products	catalog:read	Which product lines accept new orders

Customers

Method	Endpoint	Ability	Description
GET	/api/reseller/customers	customers:read	List. Supports ?search=
POST	/api/reseller/customers	customers:write	Create a customer
GET	/api/reseller/customers/{id}	customers:read	Read one
PUT	/api/reseller/customers/{id}	customers:write	Update
PUT	/api/reseller/customers/{id}/password	customers:write	Set a new password
POST	/api/reseller/customers/{id}/suspend	customers:write	Block portal login
POST	/api/reseller/customers/{id}/unsuspend	customers:write	Restore login

CDN services

Method	Endpoint	Ability	Description
GET	/api/reseller/services	services:read	List. Filter by customer_id, status
POST	/api/reseller/services	services:write	Order a CDN service. Idempotency-Key required
GET	/api/reseller/services/{id}	services:read	Read one
POST	/api/reseller/services/{id}/suspend	services:write	Suspend delivery
POST	/api/reseller/services/{id}/unsuspend	services:write	Resume delivery

Cloud VPS

Method	Endpoint	Ability	Description
GET	/api/reseller/vps	services:read	List instances
POST	/api/reseller/vps	services:write	Order a VPS. Idempotency-Key required
GET	/api/reseller/vps/{id}	services:read	Read one
POST	/api/reseller/vps/{id}/suspend	services:write	Power off
POST	/api/reseller/vps/{id}/unsuspend	services:write	Power on

Hosting

Method	Endpoint	Ability	Description
GET	/api/reseller/hosting	services:read	List accounts
POST	/api/reseller/hosting	services:write	Order hosting. Idempotency-Key required
GET	/api/reseller/hosting/{id}	services:read	Read one
POST	/api/reseller/hosting/{id}/suspend	services:write	Disable the account
POST	/api/reseller/hosting/{id}/unsuspend	services:write	Re-enable the account

Email

Method	Endpoint	Ability	Description
GET	/api/reseller/mail	services:read	List mailbox subscriptions
POST	/api/reseller/mail	services:write	Buy seats. Idempotency-Key required

Billing

Method	Endpoint	Ability	Description
GET	/api/reseller/credit	billing:read	Current balance and discount
GET	/api/reseller/credit/transactions	billing:read	Your credit ledger
GET	/api/reseller/orders	billing:read	Orders across your customers
GET	/api/reseller/orders/{id}	billing:read	Read one order
GET	/api/reseller/invoices	billing:read	Invoices across your customers
GET	/api/reseller/invoices/{id}	billing:read	Read one invoice

Usage

Method	Endpoint	Ability	Description
GET	/api/reseller/usage	usage:read	All customers. ?from= &to=
GET	/api/reseller/customers/{id}/usage	usage:read	One customer, by host and by day

Webhooks

Method	Endpoint	Ability	Description
GET	/api/reseller/webhooks	webhooks:read	List subscriptions
GET	/api/reseller/webhooks/events	webhooks:read	Subscribable event catalogue
POST	/api/reseller/webhooks	webhooks:write	Create. Returns the secret once
PUT	/api/reseller/webhooks/{id}	webhooks:write	Update
DELETE	/api/reseller/webhooks/{id}	webhooks:write	Delete
POST	/api/reseller/webhooks/{id}/rotate-secret	webhooks:write	Issue a new signing secret
GET	/api/reseller/webhooks/{id}/deliveries	webhooks:read	Delivery history

Delegated login

Method	Endpoint	Ability	Description
POST	/api/reseller/customers/{id}/sso	sso	Single-use 5-minute login URL

Conventions

• List endpoints are paginated. Use ?per_page= (max 200) and ?page=; totals are returned under meta.
• All monetary values are USD decimals. All timestamps are ISO 8601.
• Ability names in the tables above are shown without their reseller: prefix for brevity — the real ability is reseller:services:write and so on.