---
title: "Check availability and price before buying."
method: GET
path: "/v1/domain-purchases/check"
tags: ["Domain purchases"]
---

# Check availability and price before buying.

`GET /v1/domain-purchases/check`

## Request

- Base URL: `https://api.domainee.dev`
- URL: `https://api.domainee.dev/v1/domain-purchases/check`
- Auth: HTTP bearer

Read-only and free. Nothing is charged and nothing is reserved.

## Query parameters

- `hostname` string, required

## Response `200`

Availability and the all-in price.

- object
  - `hostname` string
  - `available` boolean
  - `totalCents` integer: What POST /v1/domain-purchases would charge for one year.
  - `currency` 'USD'

## Other responses

- `400`: The request body or query failed validation.
- `401`: Missing, malformed, revoked, or expired Bearer token.

---

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