---
title: "Check a domain's availability"
method: GET
path: "/v1/domains/research/availability"
tags: ["Domains"]
---

# Check a domain's availability

`GET /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 whether one domain is available to register, with a live registry check. Use this before buying.

## Query parameters

- `teamId` string: Optional team context. Requires access to the team.
- `name` string: The domain to look up. Pass this or `domain`; they are the same parameter.
- `domain` string: Alias for `name`. Pass one of the two.

## 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
    - `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)