Checkout domain cart (bulk)

POST

/domains/checkout/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 /domains/checkout for a single domain.

Request

Authorization

API Key

Add parameter in header

rs-x-api-key

Example:

rs-x-api-key: ********************

Body Params application/json

Examples

Responses

🟢200

application/json

Cart created and queued for registration - shape depends on collectionMethod, see schema

Bodyapplication/json

🟠401

🟠402

🟠403

🟠422

Request Example

Shell

JavaScript

Java

Swift

curl --location '/domains/checkout/bulk' \
--header 'rs-x-api-key: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "domains": [
        {
            "domainName": "acme-mail.com",
            "years": 1,
            "customPrice": 14.99,
            "nameservers": [
                "ns1.example.net",
                "ns2.example.net"
            ]
        },
        {
            "domainName": "acme-mail.io",
            "years": 2,
            "customPrice": 42,
            "nameservers": [
                "ns1.example.net",
                "ns2.example.net"
            ]
        }
    ],
    "domainsText": "acme-mail.com,acme-mail.io",
    "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": "WALLET",
    "paymentReference": "bank-transfer-2026-08-20"
}'

Response Example

{
    "status": 200,
    "message": "Domain cart checked out",
    "data": {
        "userId": "b2a1c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d",
        "cartOrderId": "9c8b7a6d-5e4f-4a3b-9c8d-1e2f3a4b5c6d",
        "orderIds": [
            "1a2b3c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d",
            "2b3c4d5e-6f7a-4b8c-9d0e-1f2a3b4c5d6e"
        ],
        "unavailableDomains": [],
        "skippedDomains": [],
        "walletBalanceAfter": 460.63,
        "orders": [
            {
                "orderId": "1a2b3c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d",
                "domainName": "acme-mail.com",
                "isProcessed": false,
                "orderStatus": null,
                "error": null
            },
            {
                "orderId": "2b3c4d5e-6f7a-4b8c-9d0e-1f2a3b4c5d6e",
                "domainName": "acme-mail.io",
                "isProcessed": false,
                "orderStatus": null,
                "error": null
            }
        ]
    }
}

Modified at 2026-08-28 13:12:25

Checkout domain cart (single domain)

Get domain