---
title: "Get pre-warmed domain detail"
method: GET
path: "/v1/prewarmed/{domain_name}"
tags: ["Pre-warmed Marketplace"]
---

# Get pre-warmed domain detail

`GET /v1/prewarmed/{domain_name}`

## Request

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

Full detail for one available pre-warmed domain, including per-address
health scores and pricing terms. Returns `404` once the domain is sold or
retired.

## Path parameters

- `domain_name` string, required

## Response `200`

Pre-warmed domain detail

- PrewarmedDomainDetailResponse
  - `data` object
    - `domain` string
    - `avg_health_score` number
    - `warming_days` integer
    - `addresses` PrewarmedAddress[]
      - `full_address` string
      - `username` string: Local part of the address.
      - `warming_health_score` number
      - `warming_status` string
    - `blocklist_status` 'clean' | 'listed' | 'unchecked'
    - `blocklist_hits` string[]
    - `blocklist_checked_at` string, date-time, nullable
    - `dynadot_registration` string, date, nullable
    - `dynadot_expiration` string, date, nullable
    - `pricing` object
      - `per_address_monthly` number
      - `domain_free_with_min_addresses` integer
      - `warming_included` boolean: Always false. Warming is stopped at sale and the mailboxes are handed over ready-to-send; ongoing warming is opt-in afterwards and billed at the standard per-mailbox rate.
      - `warming_monthly_per_mailbox` number: Cost per mailbox per month if the buyer opts into ongoing warming.
      - `minimum_term_months` integer: Always 0 — the minimum term was removed in August 2026.
  - `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
- `404`: Resource not found

---

[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)