---
title: "Browse available pre-warmed domains"
method: GET
path: "/v1/prewarmed/browse"
tags: ["Pre-warmed Marketplace"]
---

# Browse available pre-warmed domains

`GET /v1/prewarmed/browse`

## Request

- Base URL: `https://api.winnr.app`
- URL: `https://api.winnr.app/v1/prewarmed/browse`
- Auth: HTTP bearer

Lists the pre-warmed domains currently available to purchase, with their
warming age, health score and blocklist state so you can filter before buying.

Inventory is finite and shared across all customers: a domain listed here can
be claimed by another buyer at any time, so treat a `409` from
`/v1/prewarmed/purchase` as "already sold" and move to the next candidate
rather than retrying the same domain.

Domains flagged on a blocklist are never returned, even if the retirement
cron has not yet run.

## Query parameters

- `search` string
- `sort_by` 'health' | 'warming_days' | 'name'
- `include_all` boolean
- `page` integer
- `per_page` integer

## Response `200`

Available pre-warmed domains

- PrewarmedBrowseResponse
  - `data` object
    - `domains` PrewarmedDomainSummary[]
      - `domain` string
      - `status` 'warming' | 'available' | 'ingested': `warming` is the normal purchasable state. `ingested` means aged but not yet warming and is only returned with `include_all=true`.
      - `avg_health_score` number: Mean warmup health score across the domain's addresses (0-100).
      - `warming_days` integer: Days the domain has been warming.
      - `warming_progress` integer: Warming completion percentage, capped at 100 (30 days = 100%).
      - `domain_age_days` integer: Days since the domain was registered.
      - `address_count` integer: Warmed addresses currently on the domain.
      - `bison_active_count` integer: Addresses with an active warmup campaign.
      - `warming_active` boolean
      - `blocklist_status` 'clean' | 'listed' | 'unchecked'
      - `blocklist_hits` string[]: Blocklists the domain appeared on at the last check.
      - `blocklist_checked_at` string, date-time, nullable
      - `dynadot_registration` string, date, nullable: Domain registration date.
      - `dynadot_expiration` string, date, nullable: Domain expiration date.
      - `total_warmup_emails_sent` integer
      - `total_warmup_replies` integer
      - `total_warmup_saved_from_spam` integer
    - `pagination` object
      - `page` integer
      - `per_page` integer
      - `total` integer
  - `meta` Meta
    - `request_id` string
    - `timestamp` string, date-time

## Other responses

- `401`: Authentication required or token invalid
- `403`: The pre-warmed marketplace is not enabled for this account

---

[API](https://skmtc.dev/winnr/apis/winnr-api.md) · [All operations](https://skmtc.dev/winnr/apis/winnr-api/llms.txt) · [OpenAPI document](https://skmtc.dev/winnr/apis/winnr-api/revisions/a4f960beb1eb?raw)