DeluxHostAPI Reference
Orders & renewals

Place an order

POST
/v1/orders

Requires confirm: true. Inspect the resource before retrying an uncertain outcome. Requires Idempotency-Key. Use the same key and payload to replay a completed response. A 409 for a pending or failed attempt requires checking the resource; a new key could duplicate a charge or purchase.

Authorization

apiToken orders:create
headerAuthorizationBearer <token>

A personal API token: Authorization: Bearer dh_live_…. See Authentication for scopes.

Scope: orders:create

Header Parameters

Idempotency-Key*string

Unique per account and operation. Reuse only for an identical request. Completed requests replay the encrypted stored response; pending or failed attempts return 409 and are never automatically rerun.

Length1 <= length <= 128

Request Body

application/json
  1. body
items*array<>
couponCode?string
disclaimer?

Budget-VPS disclaimer accepted by the customer: version and locale of the disclaimer the quote returned. Required when the cart holds a plan that needs it; refused otherwise with details.code disclaimer_required.

confirm*boolean

Response Body

Operation completed or accepted; asynchronous actions may still be running.

application/json
  1. response
orderId*number
orderIds*array<number>
invoiceId*number
invoiceNumber*string
totalCents*number
curl -X POST 'https://api.deluxhost.net/v1/orders' \  -H "Authorization: Bearer $DELUXHOST_TOKEN" \  -H 'Idempotency-Key: string' \  -H 'Content-Type: application/json' \  -d '{  "items": [    {      "productSlug": "string",      "cycle": "string"    }  ],  "confirm": true}'
Example Response
{  "orderId": 0,  "orderIds": [    0  ],  "invoiceId": 0,  "invoiceNumber": "string",  "totalCents": 0}