1. Domains
Reseller Stack Public APIs
  • Customers
    • List customers
      GET
    • Create customer
      POST
    • Get customer
      GET
    • Update customer notes
      PATCH
    • Update customer status
      PATCH
    • Update billing details
      PATCH
  • Geo
    • List countries
      GET
    • List states
      GET
  • Pricing
    • List TLD pricing
      GET
    • Update TLD pricing
      PATCH
    • Set TLD featured
      PATCH
    • Apply bulk margin
      POST
    • Reorder TLD pricing
      POST
  • Domains
    • List domains
      GET
    • Check domain availability
      POST
    • Checkout domain cart (single domain)
      POST
    • Checkout domain cart (bulk)
      POST
    • Get domain
      GET
    • Toggle transfer lock
      PATCH
    • Toggle auto-renew
      PATCH
    • Preview renewal price
      GET
    • Renew domain now
      POST
    • Get domain history
      GET
  • Orders
    • List orders
      GET
    • Get order
      GET
  • 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
  • Webhooks
    • Delivered when domain.order.success fires
    • Delivered when domain.order.failed fires
    • Delivered when domain.renewal.success fires
    • Delivered when domain.renewal.failed fires
  • Health check
    GET
  • Get current partner
    GET
  1. Domains

List domains

GET
/domains
List the partner's domain inventory.

Request

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

Responses

🟢200
application/json
Domains
Bodyapplication/json

🟠401
🟠403
Request Request Example
Shell
JavaScript
Java
Swift
curl --location '/domains?contains=' \
--header 'rs-x-api-key: <api-key>'
Response Response Example
{
    "status": 200,
    "message": "Domains",
    "data": {
        "totalSearchedCount": 2,
        "currentPage": 1,
        "nextPage": 2,
        "totalPages": 1,
        "data": [
            {
                "id": "3f9e2a1c-6b4d-4e2a-9a3b-7c1d5e8f0a2b",
                "domain": "acme-mail.com",
                "status": "ACTIVE",
                "autoRenew": true,
                "registeredOn": "2025-03-14T10:22:00.000Z",
                "expireOn": "2027-03-14T10:22:00.000Z",
                "years": 2,
                "reseller": "RESELLER_CLUB",
                "dnsManagedBy": "GOOGLE_CLOUD_DNS",
                "purchaseType": "PAID",
                "isPrewarmup": false,
                "isSandbox": false,
                "createdAt": "2025-03-14T10:21:47.000Z",
                "lastOrderPrice": {
                    "orderId": "8a1c2d3e-4f5a-6b7c-8d9e-0f1a2b3c4d5e",
                    "price": 14.39,
                    "partnerPrice": 11.99
                }
            },
            {
                "id": "7b1d4e6f-2a3b-4c5d-8e9f-1a2b3c4d5e6f",
                "domain": "acme-outreach.io",
                "status": "GRACE_PERIOD",
                "autoRenew": false,
                "registeredOn": "2024-06-01T08:00:00.000Z",
                "expireOn": "2026-06-01T08:00:00.000Z",
                "years": 2,
                "reseller": "NAMECHEAP",
                "dnsManagedBy": "CLOUDFLARE",
                "purchaseType": "PAID",
                "isPrewarmup": false,
                "isSandbox": false,
                "createdAt": "2024-06-01T07:59:31.000Z",
                "lastOrderPrice": null
            }
        ]
    }
}
Modified at 2026-08-28 13:12:25
Previous
Reorder TLD pricing
Next
Check domain availability
Built with