PAYMENTS - DOMAIN - CREATE DOMAIN ORDER

Payments - Domain - Create Domain Order API Endpoints

Complete documentation for all Payments - Domain - Create Domain Order related endpoints.

POST

Create Domain Order

Create a new domain registration order.

Endpoint Details

HTTP Request

POST https://0xhost.net/API/orders/create_order

Parameters

Parameter	Type	Required	Description
`user_id`	string	Yes	User UUID
`domain_name`	string	Yes	Domain name to register
`domain_suffix`	string	Yes	Domain suffix (.com, .net, etc.)
`domain_registration_term`	integer	Yes	Registration term in years

Authentication

API Key Required in header

Headers

Header	Value	Required	Description
`x-api-key`	`your_api_key_here`	Yes	Your unique API key for authentication
`Content-Type`	`application/json`	Optional	Recommended for consistent response handling

Response Fields

Field	Type	Description
`success`	boolean	Indicates if the operation was successful
`message`	string	Response message describing the result
`data`	object/array	Contains the response data

Success Response

API Response Example

{
   {
    "success": true,
    "data": [
        {
            "domain": "testdomainname.io",
            "available": true,
            "status": "available",
            "premium": false,
            "message": "Domain is available for registration",
            "dns_check": true,
            "whois_check": true
        },
    ],
    "meta": {
        "total_checked": 6,
        "available_count": 1,
        "checked_at": "2025-11-24T19:08:32+01:00",
        "filtered": false
    }
}
}

Code Examples

Programming Languages

JavaScript (Fetch API)

async function makeRequest() {
  try {
    const response = await fetch('https://0xhost.net/API/orders/create_order', {
      method: 'POST',
      headers: {
        'x-api-key': 'your_api_key_here',
        'Content-Type': 'application/json'
      },
      body: JSON.stringify({
    "user_id": "user12345-6789-0123-4567-890123456789",
    "domain_name": "exampledomain.com",
    "domain_suffix": ".com",
    "domain_registration_term": "1"
})
    });
    
    const data = await response.json();
    console.log('Response:', data);
    return data;
  } catch (error) {
    console.error('Error:', error);
  }
}

Python (Requests)

import requests
import json

def make_request(api_key):
    url = 'https://0xhost.net/API/orders/create_order'
    headers = {
        'x-api-key': api_key,
        'Content-Type': 'application/json'
    }
    data = {
    "user_id": "user12345-6789-0123-4567-890123456789",
    "domain_name": "exampledomain.com",
    "domain_suffix": ".com",
    "domain_registration_term": "1"
}
    
    response = requests.request('POST', url, headers=headers, json=data)
    
    if response.status_code == 200:
        return response.json()
    else:
        print(f'Error: {response.status_code}')
        return None

PHP (cURL)

function makeRequest($apiKey) {
    $url = 'https://0xhost.net/API/orders/create_order';
    $data = {
    "user_id": "user12345-6789-0123-4567-890123456789",
    "domain_name": "exampledomain.com",
    "domain_suffix": ".com",
    "domain_registration_term": "1"
};
    
    $ch = curl_init();
    curl_setopt($ch, CURLOPT_URL, $url);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'POST');
    curl_setopt($ch, CURLOPT_HTTPHEADER, [
        'x-api-key: ' . $apiKey,
        'Content-Type: ' . $apiKey,
        'Content-Type: application/json'
    ]);
    curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));

    $response = curl_exec($ch);
    $httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
    curl_close($ch);

    return json_decode($response, true);
}

cURL Command

curl -X POST 'https://0xhost.net/API/orders/create_order' \
  -H 'x-api-key: your_api_key_here' \
  -H 'Content-Type: application/json' \
  -d '{
    "user_id": "user12345-6789-0123-4567-890123456789",
    "domain_name": "exampledomain.com",
    "domain_suffix": ".com",
    "domain_registration_term": "1"
}'

0xHost API