Li-domains API

FUMANA /api/v1/domains/

Thathamisa Libaka Tsohle

Fumana lethathamo la li-domains tsohle tse ngotsoeng ka akhaonto ea hau.

Liparamitha tsa Potso

Parameter	Mofuta	E hlokahala	Bophara
`status`	string	Ha ho joalo	Filter by status: `active`, `pending`, `expired`, `locked`
`search`	string	Ha ho joalo	Batla libaka ka mabitso

Kopo ea Mohlala

cURL

Python

JavaScript

curl -X GET "https://admin.vps.org/api/v1/domains/" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json"

import requests

url = "https://admin.vps.org/api/v1/domains/"
headers = {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Content-Type": "application/json"
}

response = requests.get(url, headers=headers)
print(response.json())

const response = await fetch('https://admin.vps.org/api/v1/domains/', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer YOUR_API_TOKEN',
    'Content-Type': 'application/json'
  }
});

const domains = await response.json();
console.log(domains);

Karabo ea Mohlala

{
  "count": 3,
  "results": [
    {
      "id": 101,
      "domain_name": "example.com",
      "status": "active",
      "registration_date": "2023-01-15T10:30:00Z",
      "expiration_date": "2026-01-15T10:30:00Z",
      "auto_renew": true,
      "locked": true,
      "nameservers": [
        "ns1.vps.org",
        "ns2.vps.org"
      ],
      "privacy_protection": true,
      "dns_managed_by": "vps.org"
    },
    {
      "id": 102,
      "domain_name": "myapp.io",
      "status": "active",
      "registration_date": "2024-06-20T14:15:00Z",
      "expiration_date": "2025-06-20T14:15:00Z",
      "auto_renew": false,
      "locked": false,
      "nameservers": [
        "ns1.cloudflare.com",
        "ns2.cloudflare.com"
      ],
      "privacy_protection": false,
      "dns_managed_by": "external"
    }
  ]
}

Likhoutu tsa Boemo ba Karabelo

200	Lethathamo la libaka tse fumanoeng ka katleho
401	Ha ea lumelloa - Tokeno ea netefatso e fosahetseng kapa e sieo

POST /api/v1/domains/

Ngolisa Sebaka se Secha sa Marang-rang

Rekiseng lebitso la domaini e ncha. Ho fumaneha ha domaini ho lokela ho hloloheloa pele ho rekiseng.

Kopa Liparamente tsa 'Mele

Parameter	Mofuta	E hlokahala	Bophara
`domain_name`	string	E	Domain name to register (e.g., "example.com")
`years`	integer	Ha ho joalo	Registration period in years (1-10, default: 1)
`auto_renew`	boolean	Ha ho joalo	Enable automatic renewal (default: true)
`privacy_protection`	boolean	Ha ho joalo	Enable WHOIS privacy protection (default: true)
`nameservers`	array	Ha ho joalo	Custom nameservers (default: VPS.org nameservers)

Kopo ea Mohlala

cURL

Python

JavaScript

PHP

curl -X POST "https://admin.vps.org/api/v1/domains/" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "domain_name": "mynewdomain.com",
    "years": 2,
    "auto_renew": true,
    "privacy_protection": true
  }'

import requests

url = "https://admin.vps.org/api/v1/domains/"
headers = {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Content-Type": "application/json"
}
data = {
    "domain_name": "mynewdomain.com",
    "years": 2,
    "auto_renew": True,
    "privacy_protection": True
}

response = requests.post(url, headers=headers, json=data)
print(response.json())

const response = await fetch('https://admin.vps.org/api/v1/domains/', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_TOKEN',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    domain_name: 'mynewdomain.com',
    years: 2,
    auto_renew: true,
    privacy_protection: true
  })
});

const domain = await response.json();
console.log(domain);

$data = [
    'domain_name' => 'mynewdomain.com',
    'years' => 2,
    'auto_renew' => true,
    'privacy_protection' => true
];

$ch = curl_init('https://admin.vps.org/api/v1/domains/');
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer YOUR_API_TOKEN',
    'Content-Type: application/json'
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($ch);
$domain = json_decode($response, true);
curl_close($ch);

Karabo ea Mohlala

{
  "id": 103,
  "domain_name": "mynewdomain.com",
  "status": "pending",
  "registration_date": "2026-01-16T16:00:00Z",
  "expiration_date": "2028-01-16T16:00:00Z",
  "auto_renew": true,
  "locked": true,
  "nameservers": [
    "ns1.vps.org",
    "ns2.vps.org"
  ],
  "privacy_protection": true,
  "dns_managed_by": "vps.org",
  "total_cost": 24.98,
  "message": "Domain registration initiated. Processing may take 5-10 minutes."
}

Likhoutu tsa Boemo ba Karabelo

201	Domain registration initiated successfully
400	Bad Request - Invalid domain name or domain already registered
401	Ha ea lumelloa - Tokeno ea netefatso e fosahetseng kapa e sieo
402	Payment Required - Insufficient account balance

Tlhaloso: Domain registration is not instant. Status will change from pending to active within 5-10 minutes. You'll receive an email confirmation when registration completes.

FUMANA /api/v1/domains/{domain_id}/

Fumana lintlha tsa domain

Fumana tlhaiso-leseling e batsi ka sebaka sa marang-rang se itseng.

Liparamitha tsa Tsela

Parameter	Mofuta	E hlokahala	Bophara
`domain_id`	integer	E	Unique domain ID

Kopo ea Mohlala

cURL

Python

JavaScript

curl -X GET "https://admin.vps.org/api/v1/domains/101/" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json"

import requests

domain_id = 101
url = f"https://admin.vps.org/api/v1/domains/{domain_id}/"
headers = {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Content-Type": "application/json"
}

response = requests.get(url, headers=headers)
print(response.json())

const domainId = 101;
const response = await fetch(`https://admin.vps.org/api/v1/domains/${domainId}/`, {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer YOUR_API_TOKEN',
    'Content-Type': 'application/json'
  }
});

const domain = await response.json();
console.log(domain);

Karabo ea Mohlala

{
  "id": 101,
  "domain_name": "example.com",
  "status": "active",
  "registration_date": "2023-01-15T10:30:00Z",
  "expiration_date": "2026-01-15T10:30:00Z",
  "auto_renew": true,
  "locked": true,
  "nameservers": [
    "ns1.vps.org",
    "ns2.vps.org"
  ],
  "privacy_protection": true,
  "dns_managed_by": "vps.org",
  "registrar": "VPS.org",
  "days_until_expiration": 730,
  "whois_info": {
    "registrant": "Privacy Protected",
    "admin_contact": "Privacy Protected",
    "tech_contact": "Privacy Protected",
    "created_date": "2023-01-15",
    "updated_date": "2025-12-20"
  },
  "dns_records_count": 12
}

Likhoutu tsa Boemo ba Karabelo

200	Successfully retrieved domain details
401	Ha ea lumelloa - Tokeno ea netefatso e fosahetseng kapa e sieo
404	Ha e Fumanehe - Sebaka sa marang-rang ha se eo

PUT /api/v1/domains/{domain_id}/

Ho kenya likhetho

Ho nchafatsa ho hlophisoa ha domain joalo ka ho nchafatsoa ka ho toba, liserver tsa lebitso, le likhetho tsa boinotšing.

Liparamitha tsa Tsela

Parameter	Mofuta	E hlokahala	Bophara
`domain_id`	integer	E	Unique domain ID

Kopa Liparamente tsa 'Mele

Parameter	Mofuta	E hlokahala	Bophara
`auto_renew`	boolean	Ha ho joalo	Enable or disable automatic renewal
`privacy_protection`	boolean	Ha ho joalo	Enable or disable WHOIS privacy
`nameservers`	array	Ha ho joalo	Update nameservers (2-4 nameservers required)
`locked`	boolean	Ha ho joalo	Lock or unlock domain to prevent transfers

Kopo ea Mohlala

cURL

Python

JavaScript

curl -X PUT "https://admin.vps.org/api/v1/domains/101/" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "auto_renew": false,
    "nameservers": [
      "ns1.cloudflare.com",
      "ns2.cloudflare.com"
    ]
  }'

import requests

domain_id = 101
url = f"https://admin.vps.org/api/v1/domains/{domain_id}/"
headers = {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Content-Type": "application/json"
}
data = {
    "auto_renew": False,
    "nameservers": [
        "ns1.cloudflare.com",
        "ns2.cloudflare.com"
    ]
}

response = requests.put(url, headers=headers, json=data)
print(response.json())

const domainId = 101;
const response = await fetch(`https://admin.vps.org/api/v1/domains/${domainId}/`, {
  method: 'PUT',
  headers: {
    'Authorization': 'Bearer YOUR_API_TOKEN',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    auto_renew: false,
    nameservers: [
      'ns1.cloudflare.com',
      'ns2.cloudflare.com'
    ]
  })
});

const domain = await response.json();
console.log(domain);

Karabo ea Mohlala

{
  "id": 101,
  "domain_name": "example.com",
  "status": "active",
  "auto_renew": false,
  "nameservers": [
    "ns1.cloudflare.com",
    "ns2.cloudflare.com"
  ],
  "privacy_protection": true,
  "locked": true,
  "message": "Domain settings updated successfully. Nameserver changes may take up to 24 hours to propagate."
}

Likhoutu tsa Boemo ba Karabelo

200	Domain updated successfully
400	Bad Request - Invalid parameters
401	Ha ea lumelloa - Tokeno ea netefatso e fosahetseng kapa e sieo
404	Ha e Fumanehe - Sebaka sa marang-rang ha se eo

Hlakola /api/v1/domains/{domain_id}/

_Tš'oara Domain

Ho tlosa domain ho tsoa akhaonteng ea hau. Sena ha se hlakole ho ngolisoa ha domain - se e tlosa feela ho tloha ho VPS.org account management.

Liparamitha tsa Tsela

Parameter	Mofuta	E hlokahala	Bophara
`domain_id`	integer	E	Unique domain ID

Kopo ea Mohlala

cURL

Python

JavaScript

curl -X DELETE "https://admin.vps.org/api/v1/domains/101/" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json"

import requests

domain_id = 101
url = f"https://admin.vps.org/api/v1/domains/{domain_id}/"
headers = {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Content-Type": "application/json"
}

response = requests.delete(url, headers=headers)
print(response.status_code)

const domainId = 101;
const response = await fetch(`https://admin.vps.org/api/v1/domains/${domainId}/`, {
  method: 'DELETE',
  headers: {
    'Authorization': 'Bearer YOUR_API_TOKEN',
    'Content-Type': 'application/json'
  }
});

console.log(response.status);

Likhoutu tsa Boemo ba Karabelo

204	Domain removed from account successfully
401	Ha ea lumelloa - Tokeno ea netefatso e fosahetseng kapa e sieo
404	Ha e Fumanehe - Sebaka sa marang-rang ha se eo

Important: Deleting a domain from your VPS.org account does NOT cancel the registration. The domain will continue to be registered and will auto-renew if enabled. To cancel a domain registration, disable auto-renewal and let it expire.

POST /api/v1/domains/{domain_id}/transfer/

Tlosa Domain

Initiate a domain transfer to VPS.org from another registrar.

Liparamitha tsa Tsela

Parameter	Mofuta	E hlokahala	Bophara
`domain_id`	integer	E	Unique domain ID

Kopa Liparamente tsa 'Mele

Parameter	Mofuta	E hlokahala	Bophara
`auth_code`	string	E	EPP/Authorization code from current registrar
`auto_renew`	boolean	Ha ho joalo	Enable auto-renewal after transfer (default: true)

Kopo ea Mohlala

cURL

Python

JavaScript

curl -X POST "https://admin.vps.org/api/v1/domains/101/transfer/" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "auth_code": "Xy9Kl2Mn#4pQ",
    "auto_renew": true
  }'

import requests

domain_id = 101
url = f"https://admin.vps.org/api/v1/domains/{domain_id}/transfer/"
headers = {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Content-Type": "application/json"
}
data = {
    "auth_code": "Xy9Kl2Mn#4pQ",
    "auto_renew": True
}

response = requests.post(url, headers=headers, json=data)
print(response.json())

const domainId = 101;
const response = await fetch(`https://admin.vps.org/api/v1/domains/${domainId}/transfer/`, {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_TOKEN',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    auth_code: 'Xy9Kl2Mn#4pQ',
    auto_renew: true
  })
});

const transfer = await response.json();
console.log(transfer);

Karabo ea Mohlala

{
  "id": 101,
  "domain_name": "example.com",
  "transfer_status": "pending",
  "transfer_initiated_at": "2026-01-16T16:30:00Z",
  "estimated_completion": "2026-01-23T16:30:00Z",
  "message": "Domain transfer initiated. You should receive a confirmation email from your current registrar. Transfer typically completes within 5-7 days.",
  "next_steps": [
    "Check email for transfer authorization request",
    "Approve transfer with current registrar",
    "Wait for transfer to complete (5-7 days)",
    "Domain will be automatically renewed for 1 year upon completion"
  ]
}

Likhoutu tsa Boemo ba Karabelo

200	Transfer initiated successfully
400	Bad Request - Invalid auth code or domain not eligible for transfer
401	Ha ea lumelloa - Tokeno ea netefatso e fosahetseng kapa e sieo
404	Ha e Fumanehe - Sebaka sa marang-rang ha se eo
402	Payment Required - Insufficient account balance for transfer fee

Likopo tsa ho fetisetsa:

Domain e tlameha ho lokolloa ho register ea hona joale
Domain e tlameha ho ba le lilemo tse ka bang 60
E hloka khoutu e sebetsang ea EPP/Auth
Imeile ea WHOIS e tlameha ho fumaneha bakeng sa ho lumelloa
Ho fetisoa ho kenyelletsa ho nchafatsoa ha selemo sa 1 (litheko li sebetsa)

Domain Pricing

TLDs tse tsebahalang

TLD	Ho ngolisoa (1 selemo)	Ho nchafatsa	Ho fetisetsa
.com	$12.99	$12.99	$12.99
.net	$14.99	$14.99	$14.99
.org	$13.99	$13.99	$13.99
.io	$39.99	$39.99	$39.99
.dev	$14.99	$14.99	$14.99
.app	$14.99	$14.99	$14.99
.co	$24.99	$24.99	$24.99

Likarolo tse Akarelitsoeng

✓ Tšireletso ea botho ea WHOIS e mahala
✓ Ts'ebetso ea DNS e mahala
✓ Ho fetisetsa imeile
✓ Domain forwarding

✓ Free Domain Locking
✓ 24/7 Tšehetso
✓ Ho laola domaini ka bonolo
✓ Ho nchafatsa ka ho toba

Litsela tse ntle ka ho fetisisa tsa ho laola domain

Setsi sa _Seha

& Sebelisa ho koala domain: Ho thibela ho fetisoa ha litokomane tse sa lumelloeng
E_la ka ho le letona E senya tlhaiso-leseling ea hau ea botho ho WHOIS
Senya li-password tse matla: Tlosa akhaonto ea hau ea VPS.org
E_la 2FA: E-ba le boinotši bo eketsehileng ho akhaonto ea hau
_Monitha libeke: Sebetsa ka ho toba ka li-reminders tsa letsatsi

Ho hlophisa

Ho kenya DNS: Setsi sa li-nameservers ho VPS.org bakeng sa ho hlophisoa ka bonolo
Ho nchafatsa ka ho toba: E lumella ho thibela ho fela ha domain ka lebaka la ho se khone
Lintlha tsa ho ikopanya: Ho boloka tlhaiso-leseling ea mohala oa WHOIS e ncha
_DNS: Ho nahana ka mofani oa DNS oa bobeli bakeng sa ho se na letho

Lipalangoang

60-Day Lock: Domains ha li ka fetisoa ka matsatsi a 60 a ho ngolisoa kapa ho fetisoa pele
_Domene: Ho tlameha ho lokolloa ho register ea hona joale pele ho fetisoa
Fumana khoutu ea ho amohela: Reka khoutu ea EPP/authorization ho tsoa ho register ea hona joale
Check Email: U tla fumana imeile ea ho lumelloa ha ho etsoa ho fetisa
_Tšireletso: Lipalangoang li ka nka matsatsi a 5-7 ho fihlela li felile

VPS.org API

Thathamisa Libaka Tsohle

Liparamitha tsa Potso

Kopo ea Mohlala

Karabo ea Mohlala

Likhoutu tsa Boemo ba Karabelo

Ngolisa Sebaka se Secha sa Marang-rang

Kopa Liparamente tsa 'Mele

Kopo ea Mohlala

Karabo ea Mohlala

Likhoutu tsa Boemo ba Karabelo

Fumana lintlha tsa domain

Liparamitha tsa Tsela

Kopo ea Mohlala

Karabo ea Mohlala

Likhoutu tsa Boemo ba Karabelo

Ho kenya likhetho

Liparamitha tsa Tsela

Kopa Liparamente tsa 'Mele

Kopo ea Mohlala

Karabo ea Mohlala

Likhoutu tsa Boemo ba Karabelo

_Tš'oara Domain

Liparamitha tsa Tsela

Kopo ea Mohlala

Likhoutu tsa Boemo ba Karabelo

Tlosa Domain

Liparamitha tsa Tsela

Kopa Liparamente tsa 'Mele

Kopo ea Mohlala

Karabo ea Mohlala

Likhoutu tsa Boemo ba Karabelo

Domain Pricing

TLDs tse tsebahalang

Likarolo tse Akarelitsoeng

Litsela tse ntle ka ho fetisisa tsa ho laola domain

Setsi sa _Seha

Ho hlophisa

Lipalangoang