---
title: "Register Domain"
method: POST
path: "/v1/domains"
---

# Register Domain

`POST /v1/domains`

## Request

- Base URL: `https://api.aivikings.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.aivikings.ai/v1/domains`
- Auth: none declared

## Request body

- RegisterDomainRequest
  - `domain` string, required
  - `period_years` integer
  - `allow_premium` boolean: Explicitly authorize a premium-domain registration after reviewing the current domain-specific quote.
  - `currency` string, nullable: Optional prepaid billing currency. Defaults to the customer's preferred currency.
  - `customer_id` string, nullable: Optional public customer ID. When set, registration contact handles are validated before registration starts.
  - `contact_handle` string, nullable: Optional reusable contact handle to use for every registration contact role.
  - `registrant_contact_id` integer, nullable
  - `admin_contact_id` integer, nullable
  - `technical_contact_id` integer, nullable
  - `billing_contact_id` integer, nullable
  - `nameservers` string[], nullable: Optional override. When omitted, registration uses the authenticated account's default nameservers, falling back to the middleware defaults.

## Response `200`

Successful Response

- DomainStatusResponse
  - `domain` string, required
  - `status` string, required
  - `expiry` string, date-time, nullable
  - `nameservers` string[], required
  - `long_domain` boolean, required
  - `period_years` integer, required
  - `contact_handle` string, nullable
  - `registrant_verification_status` string, nullable
  - `registrant_verification_date` string, date-time, nullable
  - `provider_domain_locked` boolean, nullable
  - `provider_code` integer, nullable
  - `provider_description` string, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/aivikings/apis/aivikings-ai-agent-registrar.md) · [All operations](https://skmtc.dev/aivikings/apis/aivikings-ai-agent-registrar/llms.txt) · [OpenAPI document](https://skmtc.dev/aivikings/apis/aivikings-ai-agent-registrar/revisions/2fc32ee9d1b1?raw)