Order domain

POST

/domains/order

Transfer or register a domain. Be careful with this command as the order will be executed directly and your account will be charged. Premium domains are protected against accidental orders: a premium domain is rejected with status 400 unless accept_premium_price is sent and matches the current premium registration price (ex. VAT) returned by the rejection and by the availability endpoint. For transfers, set nameserver to retrieve to copy the domain's current nameservers. A domain that is already in the account cannot be ordered again, except a transfer of a TLD that changes the holder via transfer (currently .be).

Request

Authorization

Add parameter in header

API-Key

Example:

API-Key: ********************

Header Params

Body Params application/json

Example

{
    "domain": "string",
    "type": "register",
    "transfer_code": "string",
    "accept_premium_price": 0,
    "nameserver": "string",
    "dns_template_id": 0,
    "profile": {
        "owner": 0,
        "admin": 0,
        "tech": 0,
        "billing": 0
    }
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://mijn.host/api/v2/domains/order' \
--header 'Accept: application/json' \
--header 'User-Agent: my-application/1.0.0' \
--header 'API-Key: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "domain": "string",
    "type": "register",
    "transfer_code": "string",
    "accept_premium_price": 0,
    "nameserver": "string",
    "dns_template_id": 0,
    "profile": {
        "owner": 0,
        "admin": 0,
        "tech": 0,
        "billing": 0
    }
}'

Responses

🟢200OK

application/json

Bodyapplication/json

Example

{
    "status": 0,
    "status_description": "string",
    "data": {
        "order_id": 0
    }
}

🟠400Wrong request method

🟠400SSL connection is required

🟠400Unsupported order type. Allowed values: register, transfer

🟠400No domain set

🟠400This order exceeds your limit for ordering on credit. Please contact our customer service.

🟠400Payment afterwards is not allowed for this account. Please contact our customer service.

🟠400Domain already exists in your account

🟠400Your domain request contains an empty extension

🟠400The extension of this domain is not supported

🟠400Premium domain confirmation required or mismatched

🟠401No valid API key set

🟠401API key has expired

🟠401Remote IP address is not found in the API key whitelist

🔴500Error

Modified at 2026-09-19 11:44:28

Check domain availability

List domain extensions