Domein API

KRIJGEN /api/v1/domains/

Alle domeinen weergeven

Haal een lijst op van alle domeinen die onder uw account zijn geregistreerd.

Queryparameters

Parameter	Type	Vereist	Omschrijving
`status`	string	Nee	Filter by status: `active`, `pending`, `expired`, `locked`
`search`	string	Nee	Zoek domeinen op naam.

Voorbeeldverzoek

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

Responsstatuscodes

200	Lijst met succesvol opgehaalde domeinen
401	Niet geautoriseerd - Ongeldig of ontbrekend authenticatietoken

POST /api/v1/domains/

Nieuw domein registreren

Registreer een nieuwe domeinnaam. Beschikbaarheid van het domein dient te worden gecontroleerd voor registratie.

Parameters van de aanvraagbody

Parameter	Type	Vereist	Omschrijving
`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)

Voorbeeldverzoek

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

Responsstatuscodes

201	Domain registration initiated successfully
400	Bad Request - Invalid domain name or domain already registered
401	Niet geautoriseerd - Ongeldig of ontbrekend authenticatietoken
402	Payment Required - Insufficient account balance

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

KRIJGEN /api/v1/domains/{domain_id}/

Domeindetails opvragen

Haal gedetailleerde informatie op over een specifiek domein.

Padparameters

Parameter	Type	Vereist	Omschrijving
`domain_id`	integer	Ja	Unique domain ID

Voorbeeldverzoek

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
}

Responsstatuscodes

200	Successfully retrieved domain details
401	Niet geautoriseerd - Ongeldig of ontbrekend authenticatietoken
404	Niet gevonden - Domein bestaat niet

NEERZETTEN /api/v1/domains/{domain_id}/

Domeininstellingen bijwerken

Update domeinconfiguraties zoals auto-vernieuwing, nameservers en privacy-instellingen.

Padparameters

Parameter	Type	Vereist	Omschrijving
`domain_id`	integer	Ja	Unique domain ID

Parameters van de aanvraagbody

Parameter	Type	Vereist	Omschrijving
`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

Voorbeeldverzoek

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

Responsstatuscodes

200	Domain updated successfully
400	Bad Request - Invalid parameters
401	Niet geautoriseerd - Ongeldig of ontbrekend authenticatietoken
404	Niet gevonden - Domein bestaat niet

VERWIJDEREN /api/v1/domains/{domain_id}/

Domein verwijderen

Verwijder een domein van uw account. Dit annuleert de domeinregistratie niet - het verwijdert het alleen van uw VPS.org accountbeheer.

Padparameters

Parameter	Type	Vereist	Omschrijving
`domain_id`	integer	Ja	Unique domain ID

Voorbeeldverzoek

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

Responsstatuscodes

204	Domain removed from account successfully
401	Niet geautoriseerd - Ongeldig of ontbrekend authenticatietoken
404	Niet gevonden - Domein bestaat niet

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/

Transferdomein

Start een domeinoverdracht naar VPS.org van een andere registrar.

Padparameters

Parameter	Type	Vereist	Omschrijving
`domain_id`	integer	Ja	Unique domain ID

Parameters van de aanvraagbody

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

Voorbeeldverzoek

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

Responsstatuscodes

200	Transfer initiated successfully
400	Bad Request - Invalid auth code or domain not eligible for transfer
401	Niet geautoriseerd - Ongeldig of ontbrekend authenticatietoken
404	Niet gevonden - Domein bestaat niet
402	Payment Required - Insufficient account balance for transfer fee

Overdrachtsvereisten:

Domein moet ontgrendeld worden bij huidige registrar
Domein moet minstens 60 dagen oud zijn
Geldige EPP/Auth-code vereist
WHOIS e-mail moet toegankelijk zijn voor goedkeuring
Overdracht omvat verlenging met één jaar (tegen betaling)

Domeinprijzen

Populaire TLD's

TLD	Registratie (1 jaar)	Verlenging	Overdracht
.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

Inbegrepen functies

✓ Vrije bescherming van de WHOIS-privacy
✓ Gratis DNS-beheer
✓ Gratis e-mail doorsturen
✓ Gratis domeindoorsturen

✓ Gratis domeinvergrendeling
✓ 24/7 ondersteuning
✓ Gemakkelijk domeinbeheer
✓ Auto-hernieuwde optie

Domeinbeheer Beste praktijken

Veiligheid

Domeinvergrendeling inschakelen: Voorkomt ongeoorloofde overdrachten
Privacybescherming inschakelen: Verbergt uw persoonlijke gegevens van WHOIS
Sterke wachtwoorden gebruiken: Bescherm uw VPS.org account
2FA inschakelen: Extra beveiliging toevoegen aan uw account
Controleer de vervaldatums: Auto-vernieuwings- of agendaherinneringen instellen

Configuratie

DNS-instellingen: Point nameservers tot VPS.org voor eenvoudig beheer
Automatisch hernieuwen: In staat om toevallige domeinverval te voorkomen
Contactinformatie: Houd WHOIS contact info up-to-date
Reservekopie DNS: Overweeg secundaire DNS provider voor redundantie

Overdrachten

60-Day Lock: Domeinen kunnen niet worden overgedragen binnen 60 dagen na registratie of vorige overdracht
Domein ontgrendelen: Moet worden ontgrendeld bij huidige registrar voor overdracht
Auth-code ophalen: Vraag EPP/authorization code aan bij de huidige registrar
Controleer e-mail: U ontvangt goedkeuring e-mails tijdens het overdrachtsproces
Plan voorop: Transfers kunnen 5-7 dagen duren om te voltooien

VPS.org API

Alle domeinen weergeven

Queryparameters

Voorbeeldverzoek

Voorbeeldantwoord

Responsstatuscodes

Nieuw domein registreren

Parameters van de aanvraagbody

Voorbeeldverzoek

Voorbeeldantwoord

Responsstatuscodes

Domeindetails opvragen

Padparameters

Voorbeeldverzoek

Voorbeeldantwoord

Responsstatuscodes

Domeininstellingen bijwerken

Padparameters

Parameters van de aanvraagbody

Voorbeeldverzoek

Voorbeeldantwoord

Responsstatuscodes

Domein verwijderen

Padparameters

Voorbeeldverzoek

Responsstatuscodes

Transferdomein

Padparameters

Parameters van de aanvraagbody

Voorbeeldverzoek

Voorbeeldantwoord

Responsstatuscodes

Domeinprijzen

Populaire TLD's

Inbegrepen functies

Domeinbeheer Beste praktijken

Veiligheid

Configuratie

Overdrachten