Domains API

HEL /api/v1/domains/

Liis garee Dhammaan Domains-ka

Soo kabsado liiska domains oo dhan diiwaangashan hoos xisaabtaada.

Cabbirrada Weydiinta

_Barnaamijyada	Nooca	Loo baahan yahay	Tilmaamaha
`status`	string	Ha	Filter by status: `active`, `pending`, `expired`, `locked`
`search`	string	Ha	Ku raadi domain-yada magac ahaan

Codsi Tusaale ah

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

Jawaabta Tusaale

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

Koodhadhka Xaaladda Jawaab celinta

200	Si guul leh ayaa loo soo ceshaday liiska domain-yada
401	Aan la ogolayn - Calaamadda xaqiijinta oo aan sax ahayn ama maqan

BOOQO /api/v1/domains/

Diiwaangeli Domain Cusub

Ka diiwaangashan magac domain cusub. Domain la heli karo waa in la hubiyo ka hor diiwaangelinta.

Codso Cabbirrada Jirka

_Barnaamijyada	Nooca	Loo baahan yahay	Tilmaamaha
`domain_name`	string	Haa	Domain name to register (e.g., "example.com")
`years`	integer	Ha	Registration period in years (1-10, default: 1)
`auto_renew`	boolean	Ha	Enable automatic renewal (default: true)
`privacy_protection`	boolean	Ha	Enable WHOIS privacy protection (default: true)
`nameservers`	array	Ha	Custom nameservers (default: VPS.org nameservers)

Codsi Tusaale ah

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

Jawaabta Tusaale

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

Koodhadhka Xaaladda Jawaab celinta

201	Domain registration initiated successfully
400	Bad Request - Invalid domain name or domain already registered
401	Aan la ogolayn - Calaamadda xaqiijinta oo aan sax ahayn ama maqan
402	Payment Required - Insufficient account balance

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

HEL /api/v1/domains/{domain_id}/

Ka hel faahfaahinta Domain

Soo kabsado macluumaad faahfaahsan oo ku saabsan domain gaar ah.

Halbeegyada Wadada

_Barnaamijyada	Nooca	Loo baahan yahay	Tilmaamaha
`domain_id`	integer	Haa	Unique domain ID

Codsi Tusaale ah

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

Jawaabta Tusaale

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

Koodhadhka Xaaladda Jawaab celinta

200	Successfully retrieved domain details
401	Aan la ogolayn - Calaamadda xaqiijinta oo aan sax ahayn ama maqan
404	Lama helin - Domain ma jiro

DHIG /api/v1/domains/{domain_id}/

Ku dar

Update domain configuration sida auto-soo celinta, servers magac, iyo settings sirta ah.

Halbeegyada Wadada

_Barnaamijyada	Nooca	Loo baahan yahay	Tilmaamaha
`domain_id`	integer	Haa	Unique domain ID

Codso Cabbirrada Jirka

_Barnaamijyada	Nooca	Loo baahan yahay	Tilmaamaha
`auto_renew`	boolean	Ha	Enable or disable automatic renewal
`privacy_protection`	boolean	Ha	Enable or disable WHOIS privacy
`nameservers`	array	Ha	Update nameservers (2-4 nameservers required)
`locked`	boolean	Ha	Lock or unlock domain to prevent transfers

Codsi Tusaale ah

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

Jawaabta Tusaale

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

Koodhadhka Xaaladda Jawaab celinta

200	Domain updated successfully
400	Bad Request - Invalid parameters
401	Aan la ogolayn - Calaamadda xaqiijinta oo aan sax ahayn ama maqan
404	Lama helin - Domain ma jiro

TIRTIR /api/v1/domains/{domain_id}/

Dib u Dhig

Deji domain ka xisaabtaada. Tani ma joojinayso diiwaangelinta domain - waxay ka saartaa oo keliya maamulka xisaabtaada VPS.org.

Halbeegyada Wadada

_Barnaamijyada	Nooca	Loo baahan yahay	Tilmaamaha
`domain_id`	integer	Haa	Unique domain ID

Codsi Tusaale ah

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

Koodhadhka Xaaladda Jawaab celinta

204	Domain removed from account successfully
401	Aan la ogolayn - Calaamadda xaqiijinta oo aan sax ahayn ama maqan
404	Lama helin - Domain ma jiro

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.

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

Guji

Bilow wareejinta domain in VPS.org ka registrar kale.

Halbeegyada Wadada

_Barnaamijyada	Nooca	Loo baahan yahay	Tilmaamaha
`domain_id`	integer	Haa	Unique domain ID

Codso Cabbirrada Jirka

_Barnaamijyada	Nooca	Loo baahan yahay	Tilmaamaha
`auth_code`	string	Haa	EPP/Authorization code from current registrar
`auto_renew`	boolean	Ha	Enable auto-renewal after transfer (default: true)

Codsi Tusaale ah

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

Jawaabta Tusaale

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

Koodhadhka Xaaladda Jawaab celinta

200	Transfer initiated successfully
400	Bad Request - Invalid auth code or domain not eligible for transfer
401	Aan la ogolayn - Calaamadda xaqiijinta oo aan sax ahayn ama maqan
404	Lama helin - Domain ma jiro
402	Payment Required - Insufficient account balance for transfer fee

U gudbinta shuruudaha:

Domain waa in la xiran yahay at diiwaangashan hadda
Domain waa in ay tahay ugu yaraan 60 maalmood jir
EPP/Auth code waa in la buuxiyaa
WHOIS email waa in la heli karo si loo ansixiyo
La wareegidda waxaa ku jira 1-sano oo dib u cusbooneysiin ah (lacagta ayaa khuseysa)

Qiimaha Domain

TLD-yada caanka ah

TLD	diiwaangelinta (1 sano)	Cusubeynta	La socodsiinta
.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

Sifooyinka Ku Jira

✓ Free WHOIS Ilaalinta Khaaska ah
✓ Maareynta DNS Bilaashka ah
✓ Free Email gudbinta
✓ Free Domain soo gudbinta

✓ Free Domain xirashada
✓ 24/7 taageero
✓ Maareynta Domain fudud
✓ Dooro

Maareynta Domain ee ugu Fiican

Ammaanka

Ka dhig Domain Locking: Ka hortagtaa wareejinta aan la oggolayn
Ka ilaali Khaaska ah: Fadhiisa macluumaadkaaga shakhsiga ah ka WHOIS
isticmaalo passwords xoog leh: Ilaalinta VPS.org xisaabtaada
Samee 2FA: Ku dar amniga dheeraadka ah ee xisaabtaada
Maalinta Dhacdada: Samee soo celinta otomaatiga ah ama soo celinta taariikhda

_Fikirka

Ku darista DNS: Tilmaam magacyada servers in VPS.org si loo fududeeyo maamulka
Cusubeynta otomaatiga ah: Saamaynta si looga hortago domain dhac
Macluumaad la xiriira: Ka ilaali WHOIS xiriirka macluumaadka ugu dambeeyay
DNS-ka dib u dejinta: U fiirso DNS labaad bixiyaha loogu talagalay redundancy

La socodka

60-Maalmood oo xidhan: Domains ma aha in la wareejiyo gudahood 60 maalmood ka dib diiwaangelinta ama wareejinta hore
Ka fur Domain: Waa in la furay at diiwaangashan hadda ka hor wareejinta
Codsiga: Codso EPP / lambarka oggolaanshaha ka diiwaangashan hadda
Emailka: Waxaad heli doontaa emails oggolaanshaha inta lagu jiro habka wareejinta
Qorshaha Hore: La wareegidda qaadan kartaa 5-7 maalmood si ay u dhamaystiraan

VPS.org API

Liis garee Dhammaan Domains-ka

Cabbirrada Weydiinta

Codsi Tusaale ah

Jawaabta Tusaale

Koodhadhka Xaaladda Jawaab celinta

Diiwaangeli Domain Cusub

Codso Cabbirrada Jirka

Codsi Tusaale ah

Jawaabta Tusaale

Koodhadhka Xaaladda Jawaab celinta

Ka hel faahfaahinta Domain

Halbeegyada Wadada

Codsi Tusaale ah

Jawaabta Tusaale

Koodhadhka Xaaladda Jawaab celinta

Ku dar

Halbeegyada Wadada

Codso Cabbirrada Jirka

Codsi Tusaale ah

Jawaabta Tusaale

Koodhadhka Xaaladda Jawaab celinta

Dib u Dhig

Halbeegyada Wadada

Codsi Tusaale ah

Koodhadhka Xaaladda Jawaab celinta

Guji

Halbeegyada Wadada

Codso Cabbirrada Jirka

Codsi Tusaale ah

Jawaabta Tusaale

Koodhadhka Xaaladda Jawaab celinta

Qiimaha Domain

TLD-yada caanka ah

Sifooyinka Ku Jira

Maareynta Domain ee ugu Fiican

Ammaanka

_Fikirka

La socodka