---
title: "Bulk search domain availability"
method: POST
path: "/v1/domains/search-bulk"
tags: ["Domains"]
---

# Bulk search domain availability

`POST /v1/domains/search-bulk`

## Request

- Base URL: `https://api.winnr.app`
- URL: `https://api.winnr.app/v1/domains/search-bulk`
- Auth: HTTP bearer

Check availability and pricing for multiple domains at once.
Maximum 100 domains per request.

## Request body

- object
  - `domains` string[], required: List of domain names to search
  - `subdomain_strategy` boolean: Subdomain Strategy mode: premium TLDs (.sh/.to/.vc/.io) return availability + price (premium registrar pool), and the standard four (.com/.co/.org/.net) are searchable too, priced from the account's own registrar. A mixed batch is split into one bulk search per registrar.

## Response `200`

Bulk domain availability results

- object
  - `meta` Meta
    - `request_id` string
    - `timestamp` string, date-time
  - `data` object
    - `results` object[]
      - `domain` string
      - `available` boolean, nullable
      - `price` number, nullable
      - `error` string, nullable
      - `requires_subdomain_strategy` boolean: Present (true) for premium TLDs (.sh/.to/.vc/.io): purchasable only through the Subdomain Strategy.
    - `count` integer: Total domains searched
    - `available_count` integer: Number of available domains

## Other responses

- `400`: Invalid request
- `401`: Authentication required or token invalid

---

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