Pagina domestica

ACQUIRE /api/v1/domains/

Omnia Dominia Enumera

In hoc libro sunt descripta omnes res quae in libro sunt.

Parametri Quaestionis

Parametrus	Typus	Requisitum	Descriptio
`status`	string	No	Filter by status: `active`, `pending`, `expired`, `locked`
`search`	string	No	Quaerere dominia secundum nomen

Exemplum Petitionis

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

Exemplum Responsionis

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

Codices Status Responsorum

200	Index dominiorum feliciter recuperatus
401	Non auctorizatus - Tessera authenticationis invalida vel absens

Post /api/v1/domains/

Novum Dominium Registra

Nomen dominii novum inscribere. Disponibilitas dominii ante inscriptionem verificanda est.

Parametri Corporis Petitionis

Parametrus	Typus	Requisitum	Descriptio
`domain_name`	string	Ita	Domain name to register (e.g., "example.com")
`years`	integer	No	Registration period in years (1-10, default: 1)
`auto_renew`	boolean	No	Enable automatic renewal (default: true)
`privacy_protection`	boolean	No	Enable WHOIS privacy protection (default: true)
`nameservers`	array	No	Custom nameservers (default: VPS.org nameservers)

Exemplum Petitionis

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

Exemplum Responsionis

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

Codices Status Responsorum

201	Domain registration initiated successfully
400	Bad Request - Invalid domain name or domain already registered
401	Non auctorizatus - Tessera authenticationis invalida vel absens
402	Payment Required - Insufficient account balance

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

ACQUIRE /api/v1/domains/{domain_id}/

Descriptio dominii

Despectus in Viam Speciem.

Parametri Semitae

Parametrus	Typus	Requisitum	Descriptio
`domain_id`	integer	Ita	Unique domain ID

Exemplum Petitionis

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

Exemplum Responsionis

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

Codices Status Responsorum

200	Successfully retrieved domain details
401	Non auctorizatus - Tessera authenticationis invalida vel absens
404	Non Inventum - Dominium non existit

PONE /api/v1/domains/{domain_id}/

Aequivalens

Haec pagina de re publica, de re publica, de civitate explicat.

Parametri Semitae

Parametrus	Typus	Requisitum	Descriptio
`domain_id`	integer	Ita	Unique domain ID

Parametri Corporis Petitionis

Parametrus	Typus	Requisitum	Descriptio
`auto_renew`	boolean	No	Enable or disable automatic renewal
`privacy_protection`	boolean	No	Enable or disable WHOIS privacy
`nameservers`	array	No	Update nameservers (2-4 nameservers required)
`locked`	boolean	No	Lock or unlock domain to prevent transfers

Exemplum Petitionis

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

Exemplum Responsionis

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

Codices Status Responsorum

200	Domain updated successfully
400	Bad Request - Invalid parameters
401	Non auctorizatus - Tessera authenticationis invalida vel absens
404	Non Inventum - Dominium non existit

DELE /api/v1/domains/{domain_id}/

Dominium deletae

Dominium ex tuo contu eliminat. Haec actiones non cancellant dominii inscriptionem - solum ex tuo VPS.org contu administratione eliminat.

Parametri Semitae

Parametrus	Typus	Requisitum	Descriptio
`domain_id`	integer	Ita	Unique domain ID

Exemplum Petitionis

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

Codices Status Responsorum

204	Domain removed from account successfully
401	Non auctorizatus - Tessera authenticationis invalida vel absens
404	Non Inventum - Dominium non existit

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/

Domenium transferri

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

Parametri Semitae

Parametrus	Typus	Requisitum	Descriptio
`domain_id`	integer	Ita	Unique domain ID

Parametri Corporis Petitionis

Parametrus	Typus	Requisitum	Descriptio
`auth_code`	string	Ita	EPP/Authorization code from current registrar
`auto_renew`	boolean	No	Enable auto-renewal after transfer (default: true)

Exemplum Petitionis

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

Exemplum Responsionis

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

Codices Status Responsorum

200	Transfer initiated successfully
400	Bad Request - Invalid auth code or domain not eligible for transfer
401	Non auctorizatus - Tessera authenticationis invalida vel absens
404	Non Inventum - Dominium non existit
402	Payment Required - Insufficient account balance for transfer fee

Translatio:

Domenium in registru attuali deblocare debet
Domenium minime 60 dies vetus esse debet
Validus EPP/Auth codicum necesse est
Quod est, scripsit, ad accepit.
1999 - Resolutione 1111 Consilii Securitati (resolutione 1111) condita est.

Praemium Nobelianum

Populorum nomen

TLD	Registratio (1 anno)	Renovatio	Translatio
.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

Proprietates Inclusae

✓ Liber de protezione civile
✓ De administrando dominio
✓ Liber Liber Pontificalis
✓ Liber de dominio

✓ Liber Liberae Dominis
✓ 24/7. apud
✓ Administratio administrativa
✓ Optio auto-renovationis

Praesides administrationis

Securitate

Activatio domenum lock: Nonnullae res non permissae sunt.
Protegere privationem: Informatio de persona apud WHOIS
Passwords: VPS.org incolarum habet.
Activa 2FA: Ad adiuvare securitatem extra ad tuum contum
Data expirationis: Configurare auto-renovationem vel calendarium reminders

Configuratio

Configuratio DNS: Point nameservers to VPS.org for easy management
Renovatio: Activare ut accidentalem dominii expirationem impediret
Informatio: Quod factum est, ut informationem de persona inveniat.
DNS backup: Despectus in Viam Rerum Publicarum

Translatio

60 a.C.n.) Domenium non potest translatio intra 60 dies post registrationem aut antea translatio
Descriptio dominii: Debet in registru currenti deblocare ante transferendum
Codex: Codex EPP/autorizationis a registre actuali petitus
Corregitur: Postea ad officium episcopi translatio facta est.
Planum ante: Postquam 5-7 dies in aqua sedent, expugnare possunt.

VPS.org API

Pagina domestica

Omnia Dominia Enumera

Parametri Quaestionis

Exemplum Petitionis

Exemplum Responsionis

Codices Status Responsorum

Novum Dominium Registra

Parametri Corporis Petitionis

Exemplum Petitionis

Exemplum Responsionis

Codices Status Responsorum

Descriptio dominii

Parametri Semitae

Exemplum Petitionis

Exemplum Responsionis

Codices Status Responsorum

Aequivalens

Parametri Semitae

Parametri Corporis Petitionis

Exemplum Petitionis

Exemplum Responsionis

Codices Status Responsorum

Dominium deletae

Parametri Semitae

Exemplum Petitionis

Codices Status Responsorum

Domenium transferri

Parametri Semitae

Parametri Corporis Petitionis

Exemplum Petitionis

Exemplum Responsionis

Codices Status Responsorum

Praemium Nobelianum

Populorum nomen

Proprietates Inclusae

Praesides administrationis

Securitate

Configuratio

Translatio