Managed Domain API

Managed domains allow you to purchase and manage custom domains for your organization. You can check availability, generate suggestions, and purchase domains.

Get All Domains

Check if a domain is available for purchase. Only supports .com, .org, and .xyz TLDs.

Generate Domain Suggestions

Purchase one or more domains. Creates a Stripe subscription and queues domains for processing.

bash

curl -X GET 'https://api.supersend.io/v1/managed-domains?status=active&limit=50&offset=0&sortBy=name&sortOrder=asc' -H "Authorization: Bearer <API_KEY>" -H "Content-Type: application/json"

# Response
{
  "domains": [
    {
      "id": "domain-uuid",
      "name": "example.com",
      "status": "active",
      "computed_status": "active",
      "price": 13.0,
      "expires_at": "2026-11-27T10:30:00Z",
      "createdAt": "2025-11-27T10:30:00Z",
      "mailboxCount": 3,
      "is_cancellation_pending": false,
      "current_period_end": "2026-11-27T10:30:00Z"
    }
  ],
  "count": 1,
  "totalCount": 5,
  "limit": 50,
  "offset": 0,
  "hasMore": false,
  "totalPrice": 65.0,
  "processingCount": 0,
  "nextBillingDate": "2026-11-27T10:30:00Z"
}

bash

curl -X POST 'https://api.supersend.io/v1/managed-domains/generate-suggestions' -H "Authorization: Bearer <API_KEY>" -H "Content-Type: application/json" -d '{
  "rootDomain": "example",
  "count": 10
}'

# Response
{
  "suggestions": [
    {
      "name": "getexample.com",
      "available": true
    },
    {
      "name": "tryexample.com",
      "available": true
    },
    {
      "name": "examplehq.com",
      "available": true
    }
  ]
}

bash

curl -X POST 'https://api.supersend.io/v1/managed-domains/check-availability' -H "Authorization: Bearer <API_KEY>" -H "Content-Type: application/json" -d '{
  "domain": "example.com"
}'

# Response
{
  "domain": "example.com",
  "available": true,
  "price": 13.0
}

Check Domain Availability

Purchase Domains

bash

curl -X POST 'https://api.supersend.io/v1/managed-domains/purchase' -H "Authorization: Bearer <API_KEY>" -H "Content-Type: application/json" -d '{
  "domains": ["example.com", "example.org"],
  "paymentMethodId": "pm_xxxxx",
  "forwardingAddress": "admin@example.com",
  "contactDetails": {
    "firstName": "John",
    "lastName": "Doe",
    "email": "admin@example.com",
    "phone": "+1-555-1234",
    "address": "123 Main St",
    "city": "San Francisco",
    "state": "CA",
    "zip": "94102",
    "country": "US"
  },
  "dmarcEmail": "dmarc@example.com",
  "mailboxProvider": "generic"
}'

# Response
{
  "message": "Checkout completed successfully. Domains are being processed and will be available shortly.",
  "domains": [
    {
      "id": "domain-uuid",
      "name": "example.com",
      "status": "pending",
      "price": 13.0,
      "expires_at": "2026-11-27T10:30:00Z",
      "createdAt": "2025-11-27T10:30:00Z"
    }
  ],
  "status": "processing",
  "subscription": {
    "id": "sub_xxxxx",
    "invoice": {
      "id": "in_xxxxx",
      "invoice_pdf": "https://pay.stripe.com/invoice/...",
      "hosted_invoice_url": "https://invoice.stripe.com/...",
      "receipt_number": "1234-5678"
    }
  }
}