Developer Tools

WorldVPN API

Integrate your applications with WorldVPN's powerful API and leverage all of our top features. Manage VPN services under your own brand with simple RESTful endpoints.

Documentation

API Methods & Integration

All endpoints use https://worldvpn.net/api/ as base URL

Authentication

All API requests must authenticate by submitting your reseller username and reseller password as form-data parameters. Keep your credentials secure.

Sandbox Environment

Safely test your integration by sending mode="test". Sandbox requests return realistic success responses without billing your balance.

JSON Responses

All API responses are returned as application/json containing "action" and "result" ("success" or "error" with "message").

Create VPN

POST

Creates a new shared VPN account with the specified username, password, and subscription period (1–36 months).

Request Example

cURL (CLI)
curl -X POST https://worldvpn.net/api/addVPN \
  -F resellerUsername="YourResellerUsername" \
  -F resellerPassword="YourResellerPassword" \
  -F vpnUsername="sampleuser1" \
  -F vpnPassword="samplepass123" \
  -F period="1" \
  -F mode="test"

Expected JSON Response

{ "action": "createVPN", "result": "success", "vpnUsername": "sampleUsername", "vpnPassword": "samplePassword" }

Request Parameters

Parameter Type Required
resellerUsername string Required
resellerPassword string Required
vpnUsername string Required
vpnPassword string Required
period integer Required
mode string Optional

Renew VPN

POST

Renew an existing VPN account by providing the username and the number of additional months.

Request Example

cURL (CLI)
curl -X POST https://worldvpn.net/api/renewVPN \
  -F resellerUsername="YourResellerUsername" \
  -F resellerPassword="YourResellerPassword" \
  -F vpnUsername="sampleuser1" \
  -F period="1" \
  -F mode="test"

Expected JSON Response

{ "action": "renewVPN", "result": "success" }

Request Parameters

Parameter Type Required
resellerUsername string Required
resellerPassword string Required
vpnUsername string Required
period integer Required
mode string Optional

Delete VPN

POST

Delete an expired VPN account by providing the VPN username. Active (non-expired) accounts cannot be terminated.

Request Example

cURL (CLI)
curl -X POST https://worldvpn.net/api/deleteVPN \
  -F resellerUsername="YourResellerUsername" \
  -F resellerPassword="YourResellerPassword" \
  -F vpnUsername="sampleuser1" \
  -F mode="test"

Expected JSON Response

{ "action": "deleteVPN", "result": "success", "message": "The VPN username has been terminated." }

Request Parameters

Parameter Type Required
resellerUsername string Required
resellerPassword string Required
vpnUsername string Required
mode string Optional

Change VPN Password

POST

Update the password of a VPN account. Provide the username and your new password.

Request Example

cURL (CLI)
curl -X POST https://worldvpn.net/api/changePassword \
  -F resellerUsername="YourResellerUsername" \
  -F resellerPassword="YourResellerPassword" \
  -F vpnUsername="sampleuser1" \
  -F vpnPassword="newPassword123" \
  -F mode="test"

Expected JSON Response

{ "action": "changePassword", "result": "success" }

Request Parameters

Parameter Type Required
resellerUsername string Required
resellerPassword string Required
vpnUsername string Required
vpnPassword string Required
mode string Optional

Take A Trial

POST

Create a free VPN trial account for a client by providing a valid email address.

Request Example

cURL (CLI)
curl -X POST https://worldvpn.net/api/getTrial \
  -F resellerUsername="YourResellerUsername" \
  -F resellerPassword="YourResellerPassword" \
  -F email="[email protected]" \
  -F mode="test"

Expected JSON Response

{ "action": "getTrial", "result": "success", "username": "xtrial12345", "password": "123456" }

Request Parameters

Parameter Type Required
resellerUsername string Required
resellerPassword string Required
email string Required
mode string Optional

List Servers

POST

Retrieve all WorldVPN server locations and their details.

Request Example

cURL (CLI)
curl -X POST https://worldvpn.net/api/listServers \
  -F resellerUsername="YourResellerUsername" \
  -F resellerPassword="YourResellerPassword" \
  -F mode="test"

Expected JSON Response

{ "action": "getServers", "result": "success", "servers": [ [43, "Australia S1", "103.73.65.209"], [89, "Australia S2", "103.73.64.159"], [15, "Germany S1", "116.203.253.222"] ] }

Request Parameters

Parameter Type Required
resellerUsername string Required
resellerPassword string Required
mode string Optional

Show Credit

POST

Check your reseller account credit balance.

Request Example

cURL (CLI)
curl -X POST https://worldvpn.net/api/getCredit \
  -F resellerUsername="YourResellerUsername" \
  -F resellerPassword="YourResellerPassword" \
  -F mode="test"

Expected JSON Response

{ "action": "getCredit", "result": "success", "credit": 99 }

Request Parameters

Parameter Type Required
resellerUsername string Required
resellerPassword string Required
mode string Optional

Get Reseller VPN Accounts

POST

List all VPN accounts under your reseller account.

Request Example

cURL (CLI)
curl -X POST https://worldvpn.net/api/getAccounts \
  -F resellerUsername="YourResellerUsername" \
  -F resellerPassword="YourResellerPassword" \
  -F mode="test"

Expected JSON Response

{ "action": "getAccounts", "result": "success", "accounts": [ [1, "demotestingvpn", "2026-07-19"] ] }

Request Parameters

Parameter Type Required
resellerUsername string Required
resellerPassword string Required
mode string Optional

Check VPN Credentials

POST

Verify VPN login credentials — check whether a username and password combination is valid.

Request Example

cURL (CLI)
curl -X POST https://worldvpn.net/api/checkAuth \
  -F resellerUsername="YourResellerUsername" \
  -F resellerPassword="YourResellerPassword" \
  -F vpnUsername="sampleuser1" \
  -F vpnPassword="samplepass123" \
  -F mode="test"

Expected JSON Response

{ "action": "checkAuth", "result": "success", "message": "", "expireDate": "2026-12-19" }

Request Parameters

Parameter Type Required
resellerUsername string Required
resellerPassword string Required
vpnUsername string Required
vpnPassword string Required
mode string Optional
WireGuard API

WireGuard Endpoints

Manage WireGuard peers and configurations programmatically

Add WireGuard Peer

POST

Creates a new WireGuard configuration for an active VPN user on the selected server and returns its config_id. Active configuration limits depend on the VPN account package (oneUser: 1, budget: 3, unlimited: 5, business / dedicated: 10).

Request Example

cURL (CLI)
curl -X POST https://worldvpn.net/api/addWireGuardPeer \
  -F resellerUsername="YourResellerUsername" \
  -F resellerPassword="YourResellerPassword" \
  -F vpnUsername="sampleuser1" \
  -F serverId="1" \
  -F mode="test"

Expected JSON Response

{ "action": "addWireGuardPeer", "result": "success", "config_id": 123 }

Request Parameters

Parameter Type Required
resellerUsername string Required
resellerPassword string Required
vpnUsername string Required
serverId integer Required
mode string Optional

Get WireGuard Config

POST

Retrieve a WireGuard configuration file by its wireguardId for a VPN user. Returns the plaintext WireGuard configuration under wireguard_config.

Request Example

cURL (CLI)
curl -X POST https://worldvpn.net/api/getWireGuardConfig \
  -F resellerUsername="YourResellerUsername" \
  -F resellerPassword="YourResellerPassword" \
  -F vpnUsername="sampleuser1" \
  -F wireguardId="123" \
  -F mode="test"

Expected JSON Response

{ "action": "getWireGuardConfig", "result": "success", "wireguard_config": "[Interface]\nPrivateKey = samplePrivateKey=\nAddress = 10.0.0.2/24\nDNS = 1.1.1.1, 8.8.8.8\n\n[Peer]\nPublicKey = sampleServerPublicKey=\nEndpoint = 116.203.253.222:8081\nAllowedIPs = 0.0.0.0/0, ::/0\nPersistentKeepalive = 25\n" }

Request Parameters

Parameter Type Required
resellerUsername string Required
resellerPassword string Required
vpnUsername string Required
wireguardId integer Required
mode string Optional

Delete WireGuard Peer

POST

Remove a WireGuard configuration from the database and update the server to delete the peer.

Request Example

cURL (CLI)
curl -X POST https://worldvpn.net/api/deleteWireGuardPeer \
  -F resellerUsername="YourResellerUsername" \
  -F resellerPassword="YourResellerPassword" \
  -F vpnUsername="sampleuser1" \
  -F wireguardId="123" \
  -F mode="test"

Expected JSON Response

{ "action": "deleteWireGuardPeer", "result": "success", "message": "Config deleted." }

Request Parameters

Parameter Type Required
resellerUsername string Required
resellerPassword string Required
vpnUsername string Required
wireguardId integer Required
mode string Optional
FAQ

Integration & Developer FAQ

Common questions about integrating our white-label VPN Reseller API

Ready to Integrate?

Become a reseller and get full API access to manage VPN services programmatically.

Become a Reseller →
Protect Your Privacy from $1.12/mo
1