---
title: "Check a pre-warmed domain against blocklists"
method: POST
path: "/v1/prewarmed/{domain_name}/blocklist-check"
tags: ["Pre-warmed Marketplace"]
---

# Check a pre-warmed domain against blocklists

`POST /v1/prewarmed/{domain_name}/blocklist-check`

## Request

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

Runs a live blocklist check on a pre-warmed domain, useful for re-verifying
immediately before purchase. Checks all nine lists by default, or one list
via the `list` query parameter.

Results are cached per domain for 5 minutes; a cached response is returned
with `cached: true` and no DNS lookup is performed.

## Path parameters

- `domain_name` string, required

## Query parameters

- `list` 'spamhaus_dbl' | 'surbl' | 'ivmuri' | 'nordspam_dbl' | 'sem_fresh' | 'sem_uri' | 'sem_urired' | 'sorbs_badconf' | 'sorbs_nomail'

## Response `200`

Blocklist check result

- PrewarmedBlocklistCheckResponse
  - `data` object
    - `domain` string
    - `list` string, nullable: The blocklist checked, or null when all nine were checked.
    - `status` 'clean' | 'listed' | 'rate_limited'
    - `checked_at` string, date-time
    - `cached` boolean: True when the result came from the 5-minute cache.
    - `details` object: Per-blocklist result keyed by blocklist name.
  - `meta` Meta
    - `request_id` string
    - `timestamp` string, date-time

## Other responses

- `400`: Validation error
- `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)