---
title: "Register a new domain"
method: POST
path: "/domains/register"
tags: ["Domains"]
---

# Register a new domain

`POST /domains/register`

## Request

- Base URL: `https://api.imprezahost.com/v1`
- URL: `https://api.imprezahost.com/v1/domains/register`
- Auth: API key in header `X-API-Key` and API key in header `X-API-Secret`

Checks domain availability, verifies pricing and client balance,
then creates a registration order and deducts from credit balance.
Free DNS management is automatically activated upon successful registration.

## Request body

- object
  - `domain` string, required
  - `years` integer, required
  - `nameservers` string[]

## Response `201`

Domain registered

## Other responses

- `409`: Domain not available or insufficient balance

---

[API](https://skmtc.dev/imprezahost/apis/impreza-host-public-api.md) · [All operations](https://skmtc.dev/imprezahost/apis/impreza-host-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/imprezahost/apis/impreza-host-public-api/revisions/db86511f604f?raw)