Skip to main content
POST
Register domain

Authorizations

Authorization
string
header
required

Body

application/json
domain
string
required

Domain to register, as one label plus a top-level extension -- example.com. Subdomains and second-level extensions such as .co.uk are not accepted. The extension must be active in the RDP.sh price list, which GET /domains/pricing returns.

Required string length: 3 - 253
Pattern: ^[a-zA-Z0-9]([a-zA-Z0-9-]*[a-zA-Z0-9])?\.[a-zA-Z]{2,}$
Example:

"example.com"

years
integer
default:1

Registration term in years.

Required range: 1 <= x <= 10
auto_renew
boolean
default:false

Renew the domain automatically. Auto-renewals are charged to the account balance in the week before expiry.

nameservers
string[]

Point the domain at your own nameservers instead of the RDP.sh ones. Omit to keep the RDP.sh nameservers and the managed DNS zone. If the switch fails the domain is still registered and the response carries a warning.

Required array length: 2 - 6 elements

Response

The domain was registered and the account balance was charged. In rare cases the registration lands but the managed DNS zone does not; dns_records_count is 0 when that happens and support is alerted automatically.

status
boolean
required
Example:

true

message
string
required
Example:

"Domain registered"

invoice_id
integer
required

ID of the balance invoice created for this registration.

Example:

8231

amount_charged
number
required

Gross amount deducted from the account balance, VAT included.

Example:

11.9

years
integer
required

Registration term that was purchased.

Example:

1

domain
object
required

Domain object.

warning
string

Present only when the registration succeeded but applying the requested nameservers did not. The domain is registered either way.