Skip to main content
Peeker keeps domains whose inboxes are already warmed. List what is in stock, buy the domains you want, and Peeker sends their inboxes to your workspace. The purchase is a normal order, so you track it like any other. This is separate from the pre-warmed pool, which assigns Google domains you already paid for.

1. List live stock

provider is required: google or microsoft. Add industry to see inboxes warmed for one industry.
monthly_price_cents is your price for the domain and all its inboxes. Follow links.next until it is null to read all stock. Stock is live: a domain leaves the list as soon as anyone buys it.

2. Buy domains

Send up to 25 domains from the list and the workspace that should get the inboxes. Use a live key with full permissions and an Idempotency-Key.
The response is 201 with the new order in data. Peeker charges the first month from your wallet now, then renews the order monthly from your wallet. The domain registration is included. Every domain is bought or none is:
  • 409 insufficient_inventory: a domain was sold or taken off sale since you listed it. error.details.domains names it. Nothing is charged. Pick other domains and send them with a new Idempotency-Key.
  • 402: your wallet cannot pay for the first month. Nothing is charged.
  • 403 forbidden: sandbox keys cannot buy prewarmed stock.

3. Track the order

Follow data.id with GET /orders/{id} until status is completed. The order also appears in GET /orders.
Last modified on November 17, 2026