PreWarm

Pre-warm inventory is domains (and the mailboxes on them) that already exist and have aged/warmed history, rather than a brand-new registration — useful when you don’t want to wait out a fresh domain’s own warmup period.

Method	Path	Description
`POST`	`/v1/api/prewarm/search-domains`	Search available pre-warmed domains
`POST`	`/v1/api/prewarm/search-mailboxes`	Search available pre-warmed mailboxes
`POST`	`/v1/api/prewarm/buy-domain`	Purchase a domain from pre-warm inventory
`GET`	`/v1/api/prewarm/order-status/{order_uid}`	Check a pre-warm order’s status
`POST`	`/v1/api/prewarm/check-availability`	Check whether specific pre-warmed domains are still available

Search


curl -X POST https://api.infrabox.software/v1/api/prewarm/search-domains \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "X-Workspace-Id: YOUR_WORKSPACE_UID" \
  -H "Content-Type: application/json" \
  -d '{
    "tlds": ["com", "net"],
    "min_age_days": 30,
    "min_available_mailboxes": 3,
    "platform": "GOOGLE"
  }'

Inventory availability changes as other customers buy from the same pool — call /check-availability right before /buy-domain if any time passed since you searched.

Errors

Status	Meaning
`400`	Invalid filters
`401`	Missing/invalid API key
`404`	Domain no longer available, or order not found
`500`	Internal error