---
title: "Check availability for many domains"
method: POST
path: "/v1/domains/research/availability"
tags: ["Domains"]
---

# Check availability for many domains

`POST /v1/domains/research/availability`

## Request

- Base URL: `https://api.spacefast.com`
- URL: `https://api.spacefast.com/v1/domains/research/availability`
- Auth: one of:
  - HTTP bearer
  - API key in cookie `__Host-better-auth.session_token`
  - none

Checks a batch of domains against registry zone files in one call. The answer is a fast "probably available" signal for search, about a day old, and names on TLDs Spacefast does not sell come back as not sold here. Confirm a domain with the single-domain check before buying.

## Request body

- object
  - `teamId` string: Optional team context. Requires access to the team.
  - `names` string[]
  - `domains` string[]

## Response `200`

Response for status 200

- object
  - `$schema` string, uri: Canonical JSON Schema URL for this response body. The server also sends it in the `Link: rel="describedby"` response header.
  - `data` object, required
    - `domains` object, required
    - `results` object[], required
      - `domain` string, required
      - `available` boolean, nullable, required
      - `supportedForPurchase` boolean, required
      - `purchasable` boolean, required
      - `connectable` boolean, required
      - `price` object, nullable, required
        - `amount` number, required
        - `formatted` string, required
        - `currency` 'USD', required
      - `premium` boolean, required
      - `status` 'available' | 'available_elsewhere' | 'taken' | 'unknown' | 'unsupported_tld', required
      - `source` 'dsapi' | 'rdap' | 'local', required
      - `checkedAt` string, required
      - `error` string, nullable, required

## Other responses

- `default`: Problem details (RFC 9457). Any 4xx/5xx response is one `application/problem+json` document.

---

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