Mazita ezita

Tora /api/v1/domains/

Nyora Madhomini Ese

Retrieve a list of all domains registered under your account.

Maparamita emibvunzo

Parameter	Rudzi	Zvinodiwa	Kutaura
`status`	string	Hapana	Filter by status: `active`, `pending`, `expired`, `locked`
`search`	string	Hapana	Tsvaga madhomini nemazita

Muenzaniso weChikumbiro

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);

Muenzaniso weMhinduro

{
  "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"
    }
  ]
}

Makodhi eMamiriro eMhinduro

200	Ndakabudirira kuwana runyorwa rwemadhomini
401	Hazvibvumirwi - Chiratidzo chekusimbisa chisiri chechokwadi kana kuti chiripo

POST /api/v1/domains/

Nyorera Domain Itsva

Register a new domain name. Domain availability should be checked before registration.

Kumbira Maparamita Emuviri

Parameter	Rudzi	Zvinodiwa	Kutaura
`domain_name`	string	Ehe	Domain name to register (e.g., "example.com")
`years`	integer	Hapana	Registration period in years (1-10, default: 1)
`auto_renew`	boolean	Hapana	Enable automatic renewal (default: true)
`privacy_protection`	boolean	Hapana	Enable WHOIS privacy protection (default: true)
`nameservers`	array	Hapana	Custom nameservers (default: VPS.org nameservers)

Muenzaniso weChikumbiro

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);

Muenzaniso weMhinduro

{
  "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."
}

Makodhi eMamiriro eMhinduro

201	Domain registration initiated successfully
400	Bad Request - Invalid domain name or domain already registered
401	Hazvibvumirwi - Chiratidzo chekusimbisa chisiri chechokwadi kana kuti chiripo
402	Payment Required - Insufficient account balance

Nzira: 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.

Tora /api/v1/domains/{domain_id}/

Get Domain Details

Kuwana yakazara ruzivo nezve domain.

MaParameter eNzira

Parameter	Rudzi	Zvinodiwa	Kutaura
`domain_id`	integer	Ehe	Unique domain ID

Muenzaniso weChikumbiro

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);

Muenzaniso weMhinduro

{
  "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
}

Makodhi eMamiriro eMhinduro

200	Successfully retrieved domain details
401	Hazvibvumirwi - Chiratidzo chekusimbisa chisiri chechokwadi kana kuti chiripo
404	Hazviwanikwe - Domain haipo

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

Kugadzirisa Domain Settings

Kugadzirisa domain configuration senge otomatiki-kuvandudzwa, nameservers, uye zveprivacy settings.

MaParameter eNzira

Parameter	Rudzi	Zvinodiwa	Kutaura
`domain_id`	integer	Ehe	Unique domain ID

Kumbira Maparamita Emuviri

Parameter	Rudzi	Zvinodiwa	Kutaura
`auto_renew`	boolean	Hapana	Enable or disable automatic renewal
`privacy_protection`	boolean	Hapana	Enable or disable WHOIS privacy
`nameservers`	array	Hapana	Update nameservers (2-4 nameservers required)
`locked`	boolean	Hapana	Lock or unlock domain to prevent transfers

Muenzaniso weChikumbiro

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);

Muenzaniso weMhinduro

{
  "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."
}

Makodhi eMamiriro eMhinduro

200	Domain updated successfully
400	Bad Request - Invalid parameters
401	Hazvibvumirwi - Chiratidzo chekusimbisa chisiri chechokwadi kana kuti chiripo
404	Hazviwanikwe - Domain haipo

DZIMA /api/v1/domains/{domain_id}/

_Dhirowa

Kubvisa domain kubva kune yako account. Izvi hazvisi kubvisa domain registration - zvinobvisa chete kubva kune yako VPS.org account management.

MaParameter eNzira

Parameter	Rudzi	Zvinodiwa	Kutaura
`domain_id`	integer	Ehe	Unique domain ID

Muenzaniso weChikumbiro

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);

Makodhi eMamiriro eMhinduro

204	Domain removed from account successfully
401	Hazvibvumirwi - Chiratidzo chekusimbisa chisiri chechokwadi kana kuti chiripo
404	Hazviwanikwe - Domain haipo

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/

Kutumira Domain

Kutanga kutumira domain ku VPS.org kubva kune mumwe mumiririri.

MaParameter eNzira

Parameter	Rudzi	Zvinodiwa	Kutaura
`domain_id`	integer	Ehe	Unique domain ID

Kumbira Maparamita Emuviri

Parameter	Rudzi	Zvinodiwa	Kutaura
`auth_code`	string	Ehe	EPP/Authorization code from current registrar
`auto_renew`	boolean	Hapana	Enable auto-renewal after transfer (default: true)

Muenzaniso weChikumbiro

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);

Muenzaniso weMhinduro

{
  "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"
  ]
}

Makodhi eMamiriro eMhinduro

200	Transfer initiated successfully
400	Bad Request - Invalid auth code or domain not eligible for transfer
401	Hazvibvumirwi - Chiratidzo chekusimbisa chisiri chechokwadi kana kuti chiripo
404	Hazviwanikwe - Domain haipo
402	Payment Required - Insufficient account balance for transfer fee

Kutumira zvinodiwa:

Domain inofanira kunge yavhurwa pazvino registrar
Domain inofanira kunge iri pasi pemakore 60
Valid EPP/Auth code required
WHOIS email inofanira kunge iri nyore kuwana kuti ibvumidwe
Kutumira kunosanganisira 1-gore rekupera (mutengo unobhadharwa)

Domain Pricing

Anonyanya kushandiswa TLDs

TLD	Kugadzwa (1 gore)	Kuvandudza	Kutumira
.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

Zvimiro Zvinosanganisirwa

✓ Free WHOIS Privacy Protection
✓ Free DNS Management
✓ Free Email Kutumira
✓ Free Domain Kutumira

✓ Free Domain Kuvhara
✓ 24 / 7 Kutsigira
✓ Domain Management
✓ Auto-Renewal sarudzo

Domain Management Best Practices

Kuchengetedzwa

Kuita Domain Kuvhara: Inodzivirira kuendeswa kwezvisiri pamutemo
Kuita Privacy Kudzivirirwa: Inochengeta ruzivo rwako rwemunhu kubva kuWHOIS
Usashandisa Strong Passwords: Kudzivirira yako VPS.org account
Kuita kuti 2FA iite: Kuwedzera kuchengetedzeka kwekuwedzera kune yako account
Monitor Kusvika Mazuva: Kugadzirisa otomatiki-kuvandudzwa kana kalenda remitemo

Kugadzirisa

DNS Kugadzirisa: Point nameservers to VPS.org for easy management
Auto-Kuvandudza: Kubvumira kuti udzorere kusvikira domain i expires
Contact Information: Keep WHOIS contact info up to date
Kuchengeta DNS: Kufunga pamusoro pekutanga DNS provider ye redundancy

Kutumira

60-zuva Lock: Madomains haagone kuendeswa mukati memazuva 60 kubva pakutanga kwekunyorwa kana kuendeswa
Unlock Domain: Munofanira kuvhurwa pazvino registrar pamberi pekushandurwa
Kuwana Auth Code: Kukumbira EPP / authorization code kubva kune yazvino registrar
Cheka Email: Uchawana kubvumidzwa emails panguva kushandura maitiro
Plan Ahead: Kutumira mari kunotora 5-7 mazuva kuti kugadziriswe

VPS.org API

Nyora Madhomini Ese

Maparamita emibvunzo

Muenzaniso weChikumbiro

Muenzaniso weMhinduro

Makodhi eMamiriro eMhinduro

Nyorera Domain Itsva

Kumbira Maparamita Emuviri

Muenzaniso weChikumbiro

Muenzaniso weMhinduro

Makodhi eMamiriro eMhinduro

Get Domain Details

MaParameter eNzira

Muenzaniso weChikumbiro

Muenzaniso weMhinduro

Makodhi eMamiriro eMhinduro

Kugadzirisa Domain Settings

MaParameter eNzira

Kumbira Maparamita Emuviri

Muenzaniso weChikumbiro

Muenzaniso weMhinduro

Makodhi eMamiriro eMhinduro

_Dhirowa

MaParameter eNzira

Muenzaniso weChikumbiro

Makodhi eMamiriro eMhinduro

Kutumira Domain

MaParameter eNzira

Kumbira Maparamita Emuviri

Muenzaniso weChikumbiro

Muenzaniso weMhinduro

Makodhi eMamiriro eMhinduro

Domain Pricing

Anonyanya kushandiswa TLDs

Zvimiro Zvinosanganisirwa

Domain Management Best Practices

Kuchengetedzwa

Kugadzirisa

Kutumira