Reseller API
A simple JSON API for resellers. Use it from your own website or billing system — or skip the code and use our WHMCS registrar module.
Getting started
- Become a reseller and add account credit.
- In the client area, open Domain Reseller → API & integration and create your API key.
- Add your server’s IP address to the allow-list (recommended).
Endpoint & authentication
https://mywebmanager.co.za/index.php?r=api/reseller
Send a POST request with a JSON body and your key in the X-API-Key header (or Authorization: Bearer …). Every reply is JSON: {"success":true,"data":{…}} or {"success":false,"error":{"code":"…","message":"…"}}.
curl -s https://mywebmanager.co.za/index.php?r=api/reseller \
-H "X-API-Key: YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"action":"check","domains":["example.co.za","example.com"]}'
Actions
| Action | Fields | What it does |
|---|---|---|
ping | — | Test your key; returns your tier and balance. |
balance | — | Your account credit. |
prices | — | Your 1-year register, transfer and renew price for every extension. |
check | domains (up to 50) | Availability, with your price. |
register | domain, years, nameservers, contact | Register and pay from credit. |
transfer | domain, eppcode, years, nameservers, contact | Start a transfer and pay from credit. |
renew | domain, years | Renew and pay from credit. |
domains | search (optional) | List your domains with status and expiry. |
domain | domain | One domain’s status, expiry and renewal price. |
nameservers / setnameservers | domain, nameservers (2–5) | Read or change nameservers. |
lock / setlock | domain, locked | Read or change the transfer lock. |
epp | domain | Get the transfer (EPP) code. |
contacts | domain | WHOIS contact details. |
autorenew | domain, enabled | Switch auto-renew on or off. |
Registrant contact
Pass your client’s details as contact to make them the registrant: firstname, lastname, companyname, email, address1, address2, city, state, postcode, country (2-letter code) and phonenumber (e.g. +27.821234567). Leave it out to use your own account details.
{
"action": "register",
"domain": "example.co.za",
"years": 1,
"nameservers": ["ns1.example.net", "ns2.example.net"],
"contact": {
"firstname": "Sipho", "lastname": "Ndlovu", "email": "[email protected]",
"address1": "1 Main Road", "city": "Pretoria", "state": "Gauteng",
"postcode": "0001", "country": "ZA", "phonenumber": "+27.821234567"
}
}
Errors & limits
| HTTP | Code | Meaning |
|---|---|---|
| 400 | invalid, unsupported, exists, unavailable | Something in the request needs fixing. |
| 401 | unauthorised | Missing or wrong API key. |
| 402 | insufficient_funds | Not enough credit (VAT included where it applies). |
| 403 | ip_not_allowed, forbidden | IP not on your allow-list, or API access is off. |
| 404 | not_found | That domain isn’t in your account. |
| 429 | rate_limited | Too many requests — the default limit is 120 per minute. |
A pending status on register, transfer or renew means it’s paid for and our team is completing it — you won’t be charged twice.
WHMCS registrar module
Using WHMCS? Download the module from Domain Reseller → API & integration in our client area, upload the mywebdomains folder to /modules/registrars/, activate My Web Domains under System Settings → Domain Registrars and paste your API key. It supports registration, transfers, renewals, nameservers, locks, EPP codes, domain sync, availability lookups and Registrar TLD Sync.