Domeine API

KRY /api/v1/domains/

Lys alle domeine

Onttrek 'n lys van alle domeins geregistreer onder u rekening.

Navraagparameters

Parameter	Tipe	Vereis	Beskrywing
`status`	string	Nee	Filter by status: `active`, `pending`, `expired`, `locked`
`search`	string	Nee	Soek domeine volgens naam

Voorbeeldversoek

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

Voorbeeldantwoord

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

Reaksiestatuskodes

200	Domeinelys suksesvol opgehaal
401	Ongemagtig - Ongeldige of ontbrekende verifikasietoken

AGT /api/v1/domains/

Registreer Nuwe Domein

Register 'n nuwe domein naam. Domein beskikbaarheid moet voor registrasie nagegaan word.

Versoekliggaamparameters

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

Voorbeeldversoek

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

Voorbeeldantwoord

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

Reaksiestatuskodes

201	Domain registration initiated successfully
400	Bad Request - Invalid domain name or domain already registered
401	Ongemagtig - Ongeldige of ontbrekende verifikasietoken
402	Payment Required - Insufficient account balance

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

KRY /api/v1/domains/{domain_id}/

Kry domein Details

Stuur breedvoerige inligting oor 'n spesifieke domein.

Padparameters

Parameter	Tipe	Vereis	Beskrywing
`domain_id`	integer	Ja	Unique domain ID

Voorbeeldversoek

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

Voorbeeldantwoord

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

Reaksiestatuskodes

200	Successfully retrieved domain details
401	Ongemagtig - Ongeldige of ontbrekende verifikasietoken
404	Nie gevind nie - Domein bestaan nie

AGT /api/v1/domains/{domain_id}/

Dateer op Domein Instellings

Dateer op domein opstelling soos outo-hernuwe, naambedieners, en privaatheid instellings.

Padparameters

Parameter	Tipe	Vereis	Beskrywing
`domain_id`	integer	Ja	Unique domain ID

Versoekliggaamparameters

Parameter	Tipe	Vereis	Beskrywing
`auto_renew`	boolean	Nee	Enable or disable automatic renewal
`privacy_protection`	boolean	Nee	Enable or disable WHOIS privacy
`nameservers`	array	Nee	Update nameservers (2-4 nameservers required)
`locked`	boolean	Nee	Lock or unlock domain to prevent transfers

Voorbeeldversoek

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

Voorbeeldantwoord

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

Reaksiestatuskodes

200	Domain updated successfully
400	Bad Request - Invalid parameters
401	Ongemagtig - Ongeldige of ontbrekende verifikasietoken
404	Nie gevind nie - Domein bestaan nie

VERWYDER /api/v1/domains/{domain_id}/

Skrap Domein

Delete a domain from your account. This does not cancel the domain registration - it only removes it from your VPS.org account management.

Padparameters

Parameter	Tipe	Vereis	Beskrywing
`domain_id`	integer	Ja	Unique domain ID

Voorbeeldversoek

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

Reaksiestatuskodes

204	Domain removed from account successfully
401	Ongemagtig - Ongeldige of ontbrekende verifikasietoken
404	Nie gevind nie - Domein bestaan nie

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.

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

Open oordra:

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

Padparameters

Parameter	Tipe	Vereis	Beskrywing
`domain_id`	integer	Ja	Unique domain ID

Versoekliggaamparameters

Parameter	Tipe	Vereis	Beskrywing
`auth_code`	string	Ja	EPP/Authorization code from current registrar
`auto_renew`	boolean	Nee	Enable auto-renewal after transfer (default: true)

Voorbeeldversoek

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

Voorbeeldantwoord

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

Reaksiestatuskodes

200	Transfer initiated successfully
400	Bad Request - Invalid auth code or domain not eligible for transfer
401	Ongemagtig - Ongeldige of ontbrekende verifikasietoken
404	Nie gevind nie - Domein bestaan nie
402	Payment Required - Insufficient account balance for transfer fee

Oordragte:

Domein moet ontsluit word by huidige registrateur
Domein moet ten minste 60 dae oud wees
Geldige EP/Auth-kode benodig
WHOIS epos moet toeganklik wees vir goedkeuring
Oordrag sluit 1- jaar hernuwing (fe toepas) in

Domeinverwikkeling

Gewilde TLS

Tld	Registrasie (1 jaar)	Hernieu	Open oordra:
.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

Ingesluite kenmerke

✓ Free WHOIS Privacy Beskerming
✓ Vry DNS-bestuur
✓ Vry E- pos Vorentoe
✓ Vry Domein vorentoe

✓ Vry domein Sluiting
✓ 24/7 ondersteuning
✓ Maklike domeinbestuur
✓ Outo-Reantale Opsie

Domeinbeheer die beste gebruike

Sekuriteit

Aktiveer domein Sluiting: Voorkom ongemagtigde oordragte
Aktiveer Privaatheid Beskerming: Verberg jou persoonlike inligting van WHOIS
Gebruik sterk wagwoorde: Protect your VPS.org account
Aktiveer 2FA: Voeg ekstra sekuriteit by jou rekening
Monitor Expirasie Datums: @ info: whatsthis

Opstelling

Dns Opstelling: Point nameservers to VPS.org for easy management
Outo-Reantale: Aktiveer om toevallige domein verval te voorkom
Kontak Informasie: Hou WGO-kontakinligting tot op hede
Rugsteun Dns: Beskou sekondêre DNS - verskaffer vir rooiheid

Oordragte: % 1

60-Day sluit: Domeine kan nie binne 60 dae van registrasie of vorige oorplasing oorgedra word nie
Ontsluit domein: Moet ontsluit word by huidige registrateur voor oorplasing
Kry slotkode: Versoek EP/autorisasiekode van huidige registrateur
Kyk vir nuwe pos: Jy sal goedkeuring e- pos ontvang tydens oorplasing proses
Beplan vooruit: Oordragte kan 5- 7 dae neem om te voltooi

VPS.org API

Lys alle domeine

Navraagparameters

Voorbeeldversoek

Voorbeeldantwoord

Reaksiestatuskodes

Registreer Nuwe Domein

Versoekliggaamparameters

Voorbeeldversoek

Voorbeeldantwoord

Reaksiestatuskodes

Kry domein Details

Padparameters

Voorbeeldversoek

Voorbeeldantwoord

Reaksiestatuskodes

Dateer op Domein Instellings

Padparameters

Versoekliggaamparameters

Voorbeeldversoek

Voorbeeldantwoord

Reaksiestatuskodes

Skrap Domein

Padparameters

Voorbeeldversoek

Reaksiestatuskodes

Open oordra:

Padparameters

Versoekliggaamparameters

Voorbeeldversoek

Voorbeeldantwoord

Reaksiestatuskodes

Domeinverwikkeling

Gewilde TLS

Ingesluite kenmerke

Domeinbeheer die beste gebruike

Sekuriteit

Opstelling

Oordragte: % 1