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

Register a bundle

Production
https://api.resellerstack.ai/api/v1
Production
https://api.resellerstack.ai/api/v1
POST
/domain/bundles/{offerId}/register
Register one name across every TLD in a bundle offer, at the bundle price. Works like POST /domain/register/bulk - same customer and collection methods - except the set of domains comes from the offer and must go through in full: if any name is unavailable or premium, nothing is created (409). Your wallet is charged the bundle price, split across the domains. Bundles are domains only - to add Google Workspace, use POST /gws.
Registration is asynchronous. A 201 means the order was accepted, not that the domains are registered. Every domain in data.domains starts as PENDING and is registered independently in the background. Keep the cartOrderId from the response - it identifies this order.
How you get the result - two ways:
1.
Webhooks (recommended). We send webhook events with registration updates to your webhook destination (partner dashboard, Webhooks) - one event per domain in the bundle, as each one resolves:
domain.order.success - the domain is registered.
domain.order.failed - the domain could not be registered. error carries the reason, and that domain's share of the bundle price is refunded.
Every event carries cartOrderId, orderId and the domain, so you can match it to this order. Subscribe your destination to both events before calling this endpoint. See the Webhooks section for the envelope, signature check and retries.
2.
Order status endpoint. Call GET /orders/{cartOrderId} with the cartOrderId from this response, at any time, to check the status of the order and of each domain in it (PENDING, SUCCESS or FAILED). Use this if you don't listen for webhooks, or to reconcile if a webhook was missed.
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
Path Params

Header Params

Body Params application/json

Examples

Responses

🟢201Created
application/json
Bundle checked out and queued for registration
Bodyapplication/json

🟠400Bad Request
🟠401Unauthorized
🟠402Payment Required
🟠403Forbidden
🟠404Not Found
🟠409Conflict
🟠422Validation Error
🟠425Too Early
🟠429Too Many Requests
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://api.resellerstack.ai/api/v1/domain/bundles//register' \
--header 'idempotency-key;' \
--header 'rs-x-api-key: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "domain": "tryresellerstack.com",
    "userId": "b2a1c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d",
    "newCustomer": {
        "email": "jane.doe@acme.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-11-11",
    "autoRenew": false,
    "privacyEnabled": true
}'
Response Response Example
201 - Example 1
{
    "status": 201,
    "message": "string",
    "data": {
        "cartOrderId": "string",
        "paymentStatus": "SUCCESS",
        "domains": [
            {
                "orderId": "string",
                "domainName": "string",
                "status": "SUCCESS",
                "error": "string",
                "registeredOn": "string",
                "expireOn": "string"
            }
        ],
        "bundlePurchaseId": "string",
        "offerId": "string",
        "sld": "tryresellerstack",
        "bundlePartnerTotal": 0,
        "normalPartnerTotal": 0
    }
}
Modified at 2026-11-18 17:27:45
Previous
List bundle offers for a name
Next
List contacts
Built with