Sign in

v52

OpenAPI 3.0.0raw.githubusercontent.com2026-08-03269339953.6 KB
Domains: Portfolio

Purchase new domain

Purchase and register a new domain name.

If registration fails, login to hPanel and check domain registration status.

If no payment method is provided, your default payment method will be used automatically.

If no WHOIS information is provided, default contact information for that TLD will be used. Before making request, ensure WHOIS information for desired TLD exists in your account.

Some TLDs require additional_details to be provided and these will be validated before completing purchase.

Use this endpoint to register new domains for users.

post/api/domains/v1/portfolio

Request body

domainstring required

Domain name

item_idstring required

Catalog price item ID

payment_method_idinteger

Payment method ID, default will be used if not provided

additional_detailsobject

Additional registration data, possible values depends on TLD

Example request

{
  "domain": "my-new-domain.tld",
  "item_id": "hostingercom-domain-com-usd-1y",
  "payment_method_id": 1327362,
  "domain_contacts": {
    "owner_id": 741288,
    "admin_id": 546123,
    "billing_id": 741288,
    "tech_id": 741288
  },
  "coupons": [
    [
      "Coupon 3"
    ]
  ]
}

Response

Success response

idinteger

Order ID

subscription_idstring

Subscription ID

status'completed' | 'pending' | 'processing' | 'failed' | 'refunded' | 'cancelled' | 'awaiting_payment' | 'payment_initiated' | 'fraud_refund'
currencystring

Currency code

subtotalinteger

Subtotal price (exc. VAT) in cents

totalinteger

Total price (inc. VAT) in cents

created_atstring date-time
updated_atstring date-time

Example response

{
  "id": 2957086,
  "subscription_id": "Azz353Uhl1xC54pR0",
  "status": "completed",
  "currency": "USD",
  "subtotal": 899,
  "total": 1088,
  "billing_address": {
    "first_name": "John",
    "last_name": "Doe",
    "country": "NL",
    "email": "john@doe.tld"
  },
  "created_at": "2025-02-27T11:54:22Z",
  "updated_at": "2025-03-27T11:54:22Z"
}