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.

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.

🟠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-07-09 17:04:38

Check domain availability

List domain extensions