1. Domains
ResellerStack Developer API
  • Introduction
  • Quick start
  • API Reference
    • Customers
      • List customers
      • Create customer
      • Get customer
      • Update customer notes
      • Update customer status
      • Update billing details
    • Geo
      • List countries
      • List states
    • Pricing
      • List TLD pricing
      • Update TLD pricing
      • Set TLD featured
      • Apply bulk margin
      • Reorder TLD pricing
    • Domains
      • List domains
        GET
      • Check domain availability
        POST
      • Register a domain
        POST
      • Checkout domain cart (bulk)
        POST
      • Toggle WHOIS privacy
        PATCH
      • Update domain contacts
        PATCH
      • Get domain
        GET
      • Toggle transfer lock
        PATCH
      • Toggle auto-renew
        PATCH
      • Preview renewal price
        GET
      • Renew domain now
        POST
      • Register a domain with Google Workspace
        POST
      • List bundle offers for a name
        GET
      • Register a bundle
        POST
    • Contacts
      • List contacts
      • Create contact
      • Get contact
    • Orders
      • List orders
      • Get order
    • DNS
      • List DNS records
      • Add DNS records
      • Update DNS record
      • Delete DNS record
      • Update nameservers
      • Reset nameservers
      • List DNSSEC records
      • Add DNSSEC record
      • Delete DNSSEC record
    • Wallet
      • Get wallet balance
    • Webhooks
      • workspace.pastdue
      • workspace.expired
      • workspace.txt.failed
      • workspace.renewed
      • workspace.provisioned
      • workspace.txt.ready
      • workspace.txt.propagated
      • workspace.licenses.increased
      • workspace.deleted
      • workspace.failed
      • mailbox.ready
      • mailbox.deleted
      • workspace.dkim.ready
      • workspace.dkim.propagated
      • workspace.domain.swapped
      • Delivered when domain.order.success fires
      • Delivered when domain.order.failed fires
      • Delivered when domain.renewal.success fires
      • Delivered when domain.renewal.failed fires
    • GWS
      • Google Workspace ~ Creation Flow
      • Google Workspace ~ Sandbox Environment
      • Check Workspace Exists
      • Create Workspace
      • List Workspaces
      • Delete Workspace
      • Check DNS Propagation
      • Renew Workspace
      • Change Primary Domain (Beta)
    • Licenses & Mailboxes
      • Create Mailbox
      • List Mailboxes
      • Delete Mailboxes
      • Decrease Seats
  • Health check
    GET
  • Get current partner
    GET
  1. Domains

Checkout domain cart (bulk)

Production
https://api.resellerstack.ai/api/v1
Production
https://api.resellerstack.ai/api/v1
POST
/domain/register/bulk
Create a multi-domain (2+) cart and check out. Registration is provisioned asynchronously via a queue - each domain resolves independently, and the outcome per domain arrives as a domain.order.success/domain.order.failed webhook (see the Webhooks section of this reference) or by polling GET /orders/{cartOrderId}. Use POST /domain/register for a single domain.
The customer must already have a billing record (address) on file - if none exists yet, this request fails with 425 rather than proceeding without one.
Strongly recommended: send an Idempotency-Key header - see /domain/register for why.

Request

Authorization
API Key
Add parameter in header
rs-x-api-key
Example:
rs-x-api-key: ********************
or
Header Params

Body Params application/json

Examples

Responses

🟢201
application/json
Cart created and queued for registration - paymentStatus and each domain's status vary by collectionMethod, see the examples below
Bodyapplication/json

🟠400
🟠401
🟠402
🟠403
🟠404
🟠409
🟠422
🟠425
🟠429
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://api.resellerstack.ai/api/v1/domain/register/bulk' \
--header 'idempotency-key;' \
--header 'rs-x-api-key: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "domains": [
        {
            "domainName": "example.com",
            "years": 1,
            "premiumPrice": 14.99,
            "nameservers": [
                "ns1.example.net",
                "ns2.example.net"
            ],
            "autoRenew": true,
            "privacyEnabled": true
        },
        {
            "domainName": "example.org",
            "years": 2,
            "premiumPrice": 42,
            "nameservers": [
                "ns1.example.net",
                "ns2.example.net"
            ],
            "autoRenew": false,
            "privacyEnabled": false
        }
    ],
    "domainsText": "example.com,example.org",
    "userId": "b2a1c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d",
    "newCustomer": {
        "email": "jane.doe@example.com",
        "firstName": "Jane",
        "lastName": "Doe",
        "company": "Acme Corp",
        "addressLineOne": "123 Market St",
        "addressLineTwo": "Suite 400",
        "addressLineThree": "Attn: Accounts Payable",
        "city": "San Francisco",
        "state": "CA",
        "country": "US",
        "postalCode": "94103",
        "phoneCc": "+1",
        "phone": "5551234567"
    },
    "collectionMethod": "MANUAL",
    "paymentReference": "bank-transfer-2026-08-20",
    "expectedTotal": 56.99
}'
Response Response Example
201 - MANUAL (default)
{
    "status": 201,
    "message": "Domain cart checked out",
    "data": {
        "cartOrderId": "9c8b7a6d-5e4f-4a3b-9c8d-1e2f3a4b5c6d",
        "paymentStatus": "SUCCESS",
        "domains": [
            {
                "orderId": "1a2b3c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d",
                "domainName": "example.com",
                "status": "PENDING",
                "error": null,
                "registeredOn": null,
                "expireOn": null
            },
            {
                "orderId": "2b3c4d5e-6f7a-4b8c-9d0e-1f2a3b4c5d6e",
                "domainName": "example.org",
                "status": "PENDING",
                "error": null,
                "registeredOn": null,
                "expireOn": null
            }
        ]
    }
}
Modified at 2026-10-22 09:07:25
Previous
Register a domain
Next
Toggle WHOIS privacy
Built with