> ## Documentation Index
> Fetch the complete documentation index at: https://docs.peeker.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Buy prewarmed inboxes

> List live prewarmed stock, buy exact domains, and track the order.

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](https://docs.peeker.ai/guides/pre-warmed-pool.md), 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.

```bash theme={"theme":{"light":"one-light","dark":"one-dark-pro"}}
curl "https://api.peeker.ai/partner/v1/prewarmed?provider=microsoft&per_page=50" \
  -H "Authorization: Bearer pk_live_<your-key>"
```

```json theme={"theme":{"light":"one-light","dark":"one-dark-pro"}}
{
	"data": [
		{
			"domain": "acme-outreach.com",
			"provider": "microsoft",
			"inbox_count": 50,
			"industry": "software",
			"warming_since": "2026-10-01T00:00:00.000Z",
			"monthly_price_cents": 3000,
			"currency": "USD"
		}
	],
	"links": {
		"first": "https://api.peeker.ai/partner/v1/prewarmed?provider=microsoft&per_page=50",
		"next": "https://api.peeker.ai/partner/v1/prewarmed?provider=microsoft&per_page=50&page_token=eyJ..."
	},
	"meta": {
		"path": "https://api.peeker.ai/partner/v1/prewarmed",
		"per_page": 50,
		"returned": 1
	}
}
```

`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`.

```bash theme={"theme":{"light":"one-light","dark":"one-dark-pro"}}
curl -X POST "https://api.peeker.ai/partner/v1/prewarmed/purchase" \
  -H "Authorization: Bearer pk_live_<your-key>" \
  -H "Idempotency-Key: prewarm_01HZX0BUY" \
  -H "Content-Type: application/json" \
  --data '
{
  "destination": {
    "provider": "smartlead",
    "workspace_id": "wrk_01HZX0SK1A2B3C4D5E6F7G8H"
  },
  "domains": ["acme-outreach.com"]
}'
```

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`.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.