Purchase

Preview a domain-slot purchase

Returns the price and flow for adding domain slots for the authenticated client. Does not charge.

Behavior

Send domain_slots and/or mailbox_slots. 1 domain slot = 3 mailboxes
Both fields are accepted only when they match that ratio
Existing subscription (flow=update) returns proration for the saved card
No subscription (flow=create) returns a catalog estimate

Response

Returns proration_amount and upcoming_invoice_amount
To charge or open checkout, use POST /api/v1/billing/domain-slots

post/api/v1/billing/domain-slots/preview

Request

Base URL: https://api.aerosend.io
URL: https://api.aerosend.io/api/v1/billing/domain-slots/preview
Auth: API key in header X-API-Key

Request body

domain_slotsinteger

Domain slots to add. Min 10, step 10, max 100.

mailbox_slotsinteger

Mailbox slots to add. Must be domain_slots × 3 (30, 60, ... 300).

Example request

{
  "domain_slots": 10,
  "mailbox_slots": 30
}

Response

Preview ready

successboolean

Success flag

timestampstring

Response timestamp

Example response

{
  "success": true,
  "data": {
    "flow": "update",
    "domain_slots": 10,
    "mailbox_slots": 30,
    "unit_price": 4,
    "currency_code": "USD"
  },
  "timestamp": "2025-12-14T10:30:00Z"
}

Changes

No recorded changes to this operation across all 1 revision of this API.