Order Aged Domains

Place an order for aged (aftermarket) domains from our inventory.

Same request shape as POST /orders/json but every domain is sourced from our own aged-domain inventory rather than registered fresh at a registrar. Domains are priced from the partner's aged-domain configuration and carry the remainder of the previous owner's registration term. The years field in each domain object is accepted for payload parity but ignored.

Domains are atomically reserved from inventory. If any requested domain cannot be reserved, the whole request fails with 409 and no partial reservation is made.

Pass confirm: true to queue the order for immediate payment processing. Without it, the order is created (201) but not charged or provisioned until you call POST /orders/process-order.

Google export: wrap googleOauthRoute, clientId, and appName inside a google object.
Microsoft export: pass microsoftOauthRoute at the top level.

Example

{
  "billingCycle": "MONTHLY",
  "serviceProvider": "GOOGLE",
  "domains": [{ "domain": "fastgrowth.io" }],
  "mailboxes": {
    "fastgrowth.io": [
      { "username": "alex", "firstName": "Alex", "lastName": "Smith" }
    ]
  },
  "confirm": true,
  "google": {
    "googleOauthRoute": "https://accounts.google.com/o/oauth2/v2/auth?client_id=...",
    "clientId": "123456789.apps.googleusercontent.com",
    "appName": "MySendingApp"
  }
}

Responses

🟢200Order Created and Queued (confirm=true)

application/json

Returned when confirm: true — the order is created and immediately queued for processing. metadata maps each requested domain to its status; domains that were skipped (restricted phrases, workspace validation failure) appear here with a reason.

Bodyapplication/json

🟢201Order Created (confirm omitted)

🟠400Validation Error

🟠401Unauthorized

🟠404Not Found

🟠409Domain Unavailable

curl --location 'https://customers.coldmailreseller.com/api/v1/integration/orders/aged-domains?userId=H8M9JV2S9HMPYFQW393AZHQVD4XM' \ --header 'cmr-x-api-key: <api-key>' \ --header 'Content-Type: application/json' \ --data '{ "billingCycle": "MONTHLY", "serviceProvider": "GOOGLE", "domains": [ { "domain": "fastgrowth.io", "years": 1 } ], "mailboxes": { "fastgrowth.io": [ { "username": "alex", "firstName": "Alex", "lastName": "Smith" } ] }, "confirm": true, "google": { "googleOauthRoute": "https://accounts.google.com/o/oauth2/v2/auth?client_id=123.apps.googleusercontent.com&redirect_uri=https://app.example.com/callback&scope=https://mail.google.com/&response_type=code", "clientId": "123456789-abc.apps.googleusercontent.com", "appName": "MySendingApp" }, "microsoftOauthRoute": "https://login.microsoftonline.com/common/oauth2/v2.0/authorize?client_id=...&redirect_uri=https://app.example.com/callback&scope=Mail.ReadWrite" }'

Example#

Request

Responses

Example