---
title: "Create domain"
method: POST
path: "/v1beta/domains"
tags: ["DomainService"]
---

# Create domain

`POST /v1beta/domains`

## Request body

- DomainCreateDomainRequest
  - `accept_eap_fee` number, double
  - `accept_premium_fee` number, double
  - `additional_data` DomainAdditionalData
    - `abogado_acceptance` string
    - `admin_sing_pass_id` string
    - `ae_acceptance` string
    - `allocation_token` string
    - `auth_code` string
    - `bank_acceptance` string
    - `company_registration_number` string
    - `consent_for_publishing` string
    - `coop_acceptance` string
    - `customer_uin` string
    - `customer_uin_doc_type` DomainUINDocumentType
      - `description` string
      - `doc_type` string
    - `dk_acceptance` string
    - `domain_name_variants` string[]
    - `eligibility_type` string
    - `eligibility_type_relationship` string
    - `es_annex_acceptance` string
    - `ftld_token` string
    - `gay_donation_acceptance` string
    - `gay_rights_protection_acceptance` string
    - `id_number` string
    - `id_type` string
    - `idn_script` string
    - `iisse_acceptance` string
    - `insurance_acceptance` string
    - `intended_use` string
    - `it_nexus_declaration` string — Declaration for .IT domains and SLDs Possible values: 'YES' or 'NO'.
    - `it_reseller_declaration` string — Declaration of Resellers for .IT domains and SLDs Possible values: 'YES' or 'NO'.
    - `law_acceptance` string
    - `legal_type` string
    - `maintainer` string
    - `membership_id` string
    - `mobile_phone_number_verification` string
    - `ngo_ong_eligibility_acceptance` string
    - `ngo_ong_policy_acceptance` string
    - `nz_privacy_option` string
    - `passport_number` string
    - `rurf_blocked_domains` string
    - `self_service` string
    - `trade_auth_key` string
    - `trademark` string
    - `trademark_id` string
    - `travel_acceptance` string
    - `ua_license` string
    - `vat` string
    - `verification_code` string
    - `vote_acceptance` string
    - `voto_acceptance` string
  - `admin_handle` string
  - `application_mode` string — When new gTLD is started it gets through several phases before it becomes available for registration to everybody (General availability or GA). There are several phases before GA when it is still possible to apply for a domain, but with some restrictions.
  - `application_notice_id` string
  - `application_smd` string
  - `auth_code` string
  - `autorenew` string
  - `billing_handle` string
  - `comments` string
  - `dnssec_keys` DomainDnssecKey[]
    - `alg` integer
    - `flags` integer
    - `protocol` integer
    - `pub_key` string
    - `readonly` integer
  - `domain` DomainDomain
    - `extension` string
    - `name` string
  - `is_dnssec_enabled` boolean
  - `is_easy_dmarc_enabled` boolean
  - `is_hosted_accreditation` boolean — Optional. Enables or disables hosted accreditation route. Using this field requires prior activation by the Openprovider team. Please contact sales team for more information.
  - `is_private_whois_enabled` boolean
  - `is_sectigo_dns_enabled` boolean
  - `is_spamexperts_enabled` boolean
  - `name_servers` DomainNameserver[]
    - `ip` string
    - `ip6` string
    - `name` string
    - `seq_nr` integer
  - `ns_group` string
  - `ns_template_id` integer
  - `ns_template_name` string
  - `owner_handle` string
  - `period` integer
  - `promo_code` string
  - `provider` string
  - `reseller_handle` string
  - `tech_handle` string
  - `unit` string
  - `use_domicile` boolean

## Response `200`

A successful response.

- DomainCreateDomainResponse
  - `code` integer
  - `data` DomainCreateDomainResponseData
    - `activation_date` string
    - `additional_data` DomainAdditionalData
      - `abogado_acceptance` string
      - `admin_sing_pass_id` string
      - `ae_acceptance` string
      - `allocation_token` string
      - `auth_code` string
      - `bank_acceptance` string
      - `company_registration_number` string
      - `consent_for_publishing` string
      - `coop_acceptance` string
      - `customer_uin` string
      - `customer_uin_doc_type` DomainUINDocumentType
        - `description` string
        - `doc_type` string
      - `dk_acceptance` string
      - `domain_name_variants` string[]
      - `eligibility_type` string
      - `eligibility_type_relationship` string
      - `es_annex_acceptance` string
      - `ftld_token` string
      - `gay_donation_acceptance` string
      - `gay_rights_protection_acceptance` string
      - `id_number` string
      - `id_type` string
      - `idn_script` string
      - `iisse_acceptance` string
      - `insurance_acceptance` string
      - `intended_use` string
      - `it_nexus_declaration` string — Declaration for .IT domains and SLDs Possible values: 'YES' or 'NO'.
      - `it_reseller_declaration` string — Declaration of Resellers for .IT domains and SLDs Possible values: 'YES' or 'NO'.
      - `law_acceptance` string
      - `legal_type` string
      - `maintainer` string
      - `membership_id` string
      - `mobile_phone_number_verification` string
      - `ngo_ong_eligibility_acceptance` string
      - `ngo_ong_policy_acceptance` string
      - `nz_privacy_option` string
      - `passport_number` string
      - `rurf_blocked_domains` string
      - `self_service` string
      - `trade_auth_key` string
      - `trademark` string
      - `trademark_id` string
      - `travel_acceptance` string
      - `ua_license` string
      - `vat` string
      - `verification_code` string
      - `vote_acceptance` string
      - `voto_acceptance` string
    - `auth_code` string
    - `expiration_date` string — This value might align with the registry_expiration_date. It is not the primary reference for domain expiration in Openprovider.
    - `id` integer
    - `renewal_date` string — The date and time by which a domain must be renewed to avoid expiration, please always refer to the renewal_date to process domain renewals.
    - `status` string
  - `desc` string
  - `maintenance` boolean
  - `warnings` ErrorWarning[]
    - `code` integer
    - `data` string
    - `desc` string

## Other responses

- `default` — (empty)

---

[API](https://skmtc.dev/openprovider/apis/rest-api.md) · [All operations](https://skmtc.dev/openprovider/apis/rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/openprovider/rest-api/revisions/a57b11984574/schema)