API de Dominio - Lista de Comandos de API

Comenzando con nuestra API RESTful

La API de Dynadot está diseñada para una integración fluida con tus sistemas. Nuestra API cuenta con URLs orientadas a recursos predecibles, soporta cuerpos de solicitud codificados en JSON, devuelve respuestas codificadas en JSON y XML, y se adhiere a los métodos HTTP estándar, autenticación y códigos de respuesta.Puedes utilizar la API de Dynadot tanto en modo de prueba como en modo en vivo. El modo se determina por la clave de API utilizada para autenticar tus solicitudes. El modo de prueba te permite simular y validar tu integración de API sin afectar los datos o transacciones en vivo.La API de Dynadot se centra principalmente en la gestión de dominios, el procesamiento de pedidos y servicios relacionados. Puedes realizar acciones como registrar, transferir y renovar dominios, gestionar configuraciones de DNS y ver o actualizar los pedidos de tu cuenta.Por favor, tenga en cuenta: Las creaciones, actualizaciones y eliminaciones en masa no son compatibles, y cada uno de esos tipos de solicitud está limitado a un objeto o acción.

Generando sus claves APIAntes de comenzar a realizar cualquier solicitud a la API, es esencial generar tu Clave API y tu Secreto API.Estas claves son necesarias para la autenticación y para garantizar la seguridad de tus acciones al interactuar con nuestra API.Puedes generar tanto la Clave API como el Secreto API a través de la sección API en la configuración de tu cuenta.1. Inicia sesión en tu cuenta en Dynadot.2. Navega a Herramientas > API.3. Genera tu Clave API y Secreto API desde esta página.

Únete a nuestra comunidad¿Tienes alguna idea o sugerencia? Habla directamente con nuestros ingenieros profesionales.Discord

Método HTTPLa API utiliza métodos HTTP estándar para realizar operaciones en los recursos:

Method	Description
GET	GET Request: Retrieve detailed information about a specified resource
POST	POST Request: Create a new resource
PUT	PUT Request: Fully update the specified resource
DELETE	DELETE Request: Remove the specified resource

URL

La URL base para todas las solicitudes de API es:https://api.dynadot.com/

El formato de URL completa:http://api.dynadot.com/restful/version_code/resource/{resource_identify}/action

https://api.dynadot.com/restful/v1/domains/{domain_name}/search

Version

La versión actual de la API esv2.0.0

Al construir la URL de solicitud de la API, solo es necesario incluir la versión principal. Las actualizaciones menores y de parches están diseñadas para ser compatibles hacia atrás y no introducirán cambios que rompan tu código existente. Esto garantiza estabilidad mientras te permite beneficiarte de mejoras y correcciones incrementales sin necesidad de modificar tu implementación.Cuando se lancen versiones futuras, mantendremos la compatibilidad hacia atrás con versiones anteriores durante un período de tiempo. Se introducirán nuevas características y cambios importantes en incrementos de versiones mayores.

HeaderEl encabezado de una solicitud API contiene metadatos sobre la solicitud. Estos metadatos proporcionan un contexto esencial para que el servidor procese la solicitud correctamente. Los encabezados comúnmente utilizados incluyen:

Content-TypeEspecifica el formato de los datos que se envían en el cuerpo de la solicitud. El servidor utiliza esta información para analizar la solicitud correctamente. Actualmente, el único valor aceptable es: application/json

Content-Type: application/json

AceptarInforma al servidor sobre el formato de respuesta que espera el cliente.Valores posibles: application/json, application/xml

Accept: application/json

AutorizaciónTodas las solicitudes de API deben incluir una clave de API para la autenticación. Puedes obtener tu clave de API desde el panel de control de tu cuenta.You can generate an API key in API setting page

Authorization: Bearer YOUR_API_KEY

X-Request-IDEl encabezado X-Request-ID es un encabezado opcional utilizado para identificar de manera única cada solicitud de API. Cuando se incluye, este encabezado ayuda a rastrear y correlacionar solicitudes a través de sistemas y registros, facilitando la depuración y el monitoreo de la actividad de la API.El valor de X-Request-ID debe ser un UUID (Identificador Único Universal) válido, siguiendo el formato estándar: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx (por ejemplo, 123e4567-e89b-12d3-a456-426614174000).

X-Request-ID: 550e8400-e29b-41d4-a716-446655440000

Sure! Here’s the translation of "X-Signature" into Spanish: X-FirmaEl encabezado X-Signature es un mecanismo de seguridad obligatorio para solicitudes transaccionales, incluidas aquellas que recuperan información sensible o actualizan datos. Asegura la autenticidad, integridad y no repudio de las solicitudes de API al requerir que los clientes firmen la carga útil de la solicitud utilizando HMAC-SHA256.

Para generar la firma, necesitarás los siguientes valoresClave API: Tu clave API única.2. Ruta Completa y Consulta: La ruta completa del endpoint de la API junto con los parámetros de consulta.3. X-Request-Id: El ID de la solicitud. Si no está disponible, puedes ingresar una cadena vacía.4. Cuerpo de la Solicitud: El cuerpo de la solicitud. Si está vacío o es nulo, puedes ingresar una cadena vacía.

La cadena a firmar es una combinación de los valores mencionados anteriormente, concatenados en el siguiente orden:

apiKey + "\n" + fullPathAndQuery + "\n" + (xRequestId or empty String) + "\n" + (requestBody or empty String)

apiKey = "your_api_key"
fullPathAndQuery = "/v1/some/endpoint?param=value"
xRequestId = "unique-request-id"
requestBody = "{\"key\":\"value\"}"


stringToSign = "your_api_key\n/v1/some/endpoint?param=value\nunique-request-id\n{\"key\":\"value\"}"

Generar la firma HMAC-SHA256Después de construir la cadena para firmar, necesitas aplicar HMAC-SHA256 encriptación utilizando tu clave secreta. Este proceso generará la firma.La firma se genera utilizando los siguientes pasos:1. Utiliza el algoritmo HMAC-SHA256. 2. Use the stringToSign as the input message.3. Usa el secreto como la clave.
Aplica la firma generada como el valor de X-Signature en el encabezado de la solicitud.

X-Signature: {HMAC-SHA256 Signature}

BodyEl cuerpo de una solicitud API se utiliza para enviar datos al servidor. Comúnmente se incluye en solicitudes POST, PUT o PATCH (no suele utilizarse en solicitudes GET o DELETE).

Content FormatEl formato de los datos del cuerpo está determinado por el encabezado Content-Type. Algunos formatos comunes incluyen:

{

domainName: "domain.com",
showPrice: "yes",
currency: "USD"

}

Casos de Uso TípicosSolicitudes POST: El método POST se utiliza para crear un nuevo recurso en el servidor. El cuerpo de la solicitud generalmente contiene los detalles del recurso.Solicitudes PUT: El método PUT se utiliza para actualizar un recurso existente reemplazándolo por completo. El cuerpo de la solicitud contiene el recurso actualizado en su totalidad.DELETE Requests: El método DELETE se utiliza para eliminar un recurso existente del servidor. No tiene un cuerpo de solicitud.GET Requests: El método GET se utiliza para recuperar un recurso existente del servidor. No tiene un cuerpo de solicitud

Response FormatTodas las respuestas de la API se devuelven en formato JSON o XML, y el formato de los datos del cuerpo se determina por el encabezado Accept, proporcionando los datos solicitados o un mensaje de error, si corresponde.

Content FormatThe response in general contains 3 parts: Code, Message, Data

Código: El estado de la solicitudMensaje: Más descripción del estadoDatos: El cuerpo de la respuesta

{

Code: "200",
Message: "Success",
Data: {}

}

Manejo de ErroresLos códigos de estado HTTP son números estandarizados de tres dígitos que devuelve un servidor para indicar el resultado de la solicitud de un cliente. Proporcionan información esencial sobre si la solicitud se procesó correctamente, si requiere una acción adicional o si se encontró un error. Estos códigos se dividen en cinco categorías, cada una representando un tipo distinto de respuesta.Los códigos de estado de nuestra API se adhieren al protocolo HTTP/1.1, un estándar ampliamente aceptado que garantiza una comunicación consistente y confiable. Al utilizar HTTP/1.1, aprovechamos características como conexiones persistentes y un mejor almacenamiento en caché para optimizar las interacciones entre el cliente y el servidor.

2xx (Exitoso): Indica que el comando fue recibido y aceptado.

200El código de estado indica que la solicitud ha tenido éxito.

201El código de estado indica que la solicitud ha sido cumplida y ha resultado en la creación de uno o más nuevos recursos.

202El código de estado indica que la solicitud ha sido aceptada para su procesamiento, pero el procesamiento no se ha completado.

249El usuario ha enviado demasiadas solicitudes en un período de tiempo determinado.

4xx (Error del Cliente): Indica que el cliente cometió un error en la solicitud, como proporcionar una entrada no válida o carecer de la autorización adecuada.

400El código de estado indica que el servidor no puede o no procesará la solicitud debido a algo que se percibe como un error del cliente.

401El código de estado indica que la solicitud no se ha aplicado porque carece de credenciales de autenticación válidas para el recurso objetivo.

402El código de estado indica que la solicitud no se ha aplicado debido a un problema de pago.

403El código de estado indica que el servidor entendió la solicitud pero se niega a cumplirla.

404El código de estado indica que el servidor de origen no encontró una representación actual para el recurso objetivo o no está dispuesto a revelar que existe una.

409La solicitud no se pudo completar debido a un conflicto con el estado actual del recurso.

5xx (Error del Servidor): Indica que el servidor encontró un error o no puede cumplir con la solicitud.

500El código de estado indica que el servidor encontró una condición inesperada que le impidió cumplir con la solicitud.

501El código de estado indica que el servidor no soporta la funcionalidad necesaria para cumplir con la solicitud.

502El código de estado indica que el servidor, al actuar como un gateway o proxy, recibió una respuesta inválida de un servidor de entrada al que accedió mientras intentaba cumplir con la solicitud.

503El código de estado indica que el servidor no puede manejar la solicitud en este momento debido a una sobrecarga temporal o mantenimiento programado, lo que probablemente se resolverá después de un breve retraso.

504El código de estado indica que el servidor, al actuar como un gateway o proxy, no recibió una respuesta oportuna de un servidor ascendente al que necesitaba acceder para completar la solicitud.

de dominio.Nombre del Estado

200Éxito

201Creado

202Aceptado

249Demasiadas solicitudes

400Solicitud incorrecta

401No autorizado

402Pago Requerido

403Prohibido

404No encontrado

409Conflicto

500Error Interno del Servidor

501No implementado

502Puerta de enlace incorrecta

503Servicio no disponible

504Tiempo de espera de la puerta de enlace

Limitación de tasaLas solicitudes deben enviarse a través de https (socket seguro) por razones de seguridad. Solo se puede procesar 1 solicitud a la vez, así que por favor espera a que tu solicitud actual termine antes de enviar otra solicitud.

Recibirás diferentes conteos de hilos según el nivel de precio de tu cuenta:

Price level	Thread Count	Rate Limit
Regular	1 thread	60/min (1/sec)
Bulk	5 threads	600/min (10/sec)
Super Bulk	25 threads	6000/min (100/sec)

Nota: place_auction_bid & get_auction_bid están actualmente exentos del límite de tasa anterior.

<Response>
  <status>
    <code>429</code>
    <message>Too Many Requests</message>
  </status>
  <error>
    <description>You have reached the maximum allowed requests within the concurrent limit of your account. Please try again later.</description>
  </error>
</Response>

{

code: 429,
message: "Too Many Requests",
error: {
- description: "You have reached the maximum allowed requests within the concurrent limit of your account. Please try again later."
1 item}

}

Resumen del Registro de Cambios

Un Registro de Cambios es un registro detallado de cambios, mejoras, correcciones de errores y nuevas características introducidas en cada versión de la API. Proporciona transparencia para los usuarios y desarrolladores al documentar el impacto de cada actualización. Se compone de dos partes clave:

Versión de la APIEsta parte destaca el sistema de versionado de la API, que ayuda a los desarrolladores a seguir la evolución de las características y garantizar la compatibilidad. Cada versión de la API se identifica con un número de versión único (por ejemplo, v1.0.1, v2.2.3) y representa un hito o lanzamiento significativo. El versionado permite a los usuarios mantener integraciones con una interrupción mínima al optar por actualizaciones cuando estén listos.

Historial de CambiosEl Historial de Cambios proporciona información detallada sobre actualizaciones, correcciones de errores, descontinuaciones y mejoras introducidas en cada versión. Describe los cambios específicos realizados en los puntos finales, parámetros, mecanismos de autenticación o formatos de respuesta. Esta sección garantiza que los desarrolladores tengan total transparencia sobre lo que ha cambiado y puedan ajustar sus implementaciones en consecuencia. Al mantener un registro de cambios claro y detallado, nuestro objetivo es proporcionar a los desarrolladores las herramientas y la información necesarias para gestionar integraciones de manera efectiva y con confianza.

Versión de la API

Nuestra API está actualmente en la versiónv2.0.0

Los códigos de versión se utilizan para identificar y gestionar de manera sistemática las actualizaciones de la API. Siguen el formato de Versionado Semántico (SemVer):

Cada componente del código de versión cumple un propósito específico y ayuda a los desarrolladores a comunicar de manera efectiva el alcance y tipo de cambios.

Versión PrincipalDefinición: Representa cambios significativos que pueden romper la compatibilidad hacia atrás.Format:<Major>.x.x

Ejemplos:v1.0.0->v2.0.0Un rediseño completo de la API o cambios en el esquema incompatibles.

Versión menorDefinición: Indica adiciones de características compatibles hacia atrás.Format:x.<Minor>.x

Ejemplos:v1.0.0->v1.1.0Agregar nuevos puntos finales o métodos mientras se mantiene la compatibilidad hacia atrás.

Versión del parcheDefinición: Se refiere a correcciones de errores compatibles hacia atrás o mejoras menores.Format:x.x.<Patch>

Ejemplos:v1.0.0->v1.1.0Corrigiendo un error menor en un punto final de la API.

Registro de Cambios de la API

Un registro de cambios es un documento detallado de las modificaciones, mejoras, correcciones de errores y nuevas funciones introducidas en cada versión de un software o una API. Proporciona transparencia para los usuarios y desarrolladores al documentar el impacto de cada actualización.

Una entrada típica en un registro de cambios incluye:Descripción: Una breve explicación de lo que se cambió.Componentes Afectados: Módulos específicos, puntos finales o características afectadas por el cambio.

Ejemplo: Se agregó soporte para este nuevo comando de API<Domain Register>

Historial de CambiosMantente al tanto de cada cambio en la API de Dynadot.

March 15, 2025

v1.0.0The Dynadot API 1.0.0 introduces a RESTful interface designed for seamless integration with your systems.

It features predictable resource-oriented URLs, supports standard HTTP methods and authentication, and returns responses in both JSON and XML formats.

Each request processes a single object or action, as bulk updates are not supported.

This version focuses on core domain management, order processing, and related services.
Users can register, transfer, and renew domains, manage DNS settings, view or update account orders, as well as access functionalities for aftermarket, site builder, email hosting, and more.

To facilitate collaboration and support, we provide a dedicated Discord channel where users can discuss API usage, share feedback, and receive updates.

October 9, 2025

v2.0.0New Features & Key Changes • Sandbox Environment Now Live ◦ The Sandbox environment is officially launched and available for safe testing and integration validation. • Mandatory X-Signature Header for Sensitive Operations ◦ To enhance security, the X-Signature header is now enforced for all sensitive API commands. • (Optional) Machine-Readable API Documentation ◦ We now support structured, machine-readable API documentation for easier integration with automated tools. • Search Access Restricted ◦ Access to certain search-related endpoints has been restricted for performance and data control reasons. • IP whitelisting optimized ◦ Reseller account no longer required to enter at least 1 IP to use API(RESTful API only) API Documentation Improvements • Updated version selector on the documentation landing page for easier navigation • Unified casing conventions across parameter names • Expanded documentation and usage guidance for the bulk_search endpoint • Added feature to hide/show side navigation

Introduced mandatory paging parameters to improve response efficiency and consistency. ◦ page (integer, required) – Specifies the current page index, starting from 1. ◦ page_size (integer, required) – Defines the number of items returned per page.get_listings

March 15, 2025
October 9, 2025

SEARCH Command

Support multi-thread

Support API Sandbox

If calling the search command, the following parameters should be included:

Request Parameters Expand All

show_price Boolean Optional

If you would like to display price for available search result.
currency String Optional

The currency of the price result.
Supported valuesusd, gbp, eur, inr, pln, zar, ltl, cny, cad, jpy, nzd, rub, aud, mxn, brl, idr, ars, cop, dkk, rsd, hkd, chf, aed, myr, ngn, kes, czk, btc, nok

Result Parameters Expand All

domain_name String

The domain name.
available Boolean

Is the domain available.
premium String

Is the domain premium.
Supported valuesyes, no, unknown
show_price Boolean

Is the domain require price.
currency String

The currency of the price result.
registration_price List

The price of registration.
renewal_price List

The price of renewal.
transfer_price String

The price of transfer.
restore_price String

The price of restore.

Api Request and Header

GET https://api.dynadot.com/restful/v1/domains/{domain_name}/search

Accept: application/json

Authorization: Bearer API_KEY

Response

{

code: "Integer",
message: "String",
data: {
- domain_name: "String",
- available: "String",
- premium: "String",
- price_list: [
  1. {
    - currency: "String",
    - unit: "String",
    - transfer: "String",
    - restore: "String"
    }
  ]
}

}

BULK_SEARCH Command

Support multi-thread

Support API Sandbox

If calling the bulk_search command, the following parameters should be included:

Request Parameters Expand All

domain_name_list List
Specifies multiple domain names to be included in the bulk search request.Multiple domains must be listed as a single string, using commas (,) as separators, without any whitespace between entries.

The maximum number of domain names permitted in a single request is determined by the account's pricing tier:
Pricing Tier - Maximum Domains
Regular - 5
Bulk - 10
Super Bulk - 20

Example:
```
domain_name_list=example1.com,example2.net,example3.org
```
.

Result Parameters Expand All

domain_result_list List
The Domain Search Result List.
Show Properties
- domain_name String
  
  The domain name.
- available Boolean
  
  The domain available status.
- details_error_message String
  
  The search result details error message.

Api Request and Header

GET https://api.dynadot.com/restful/v1/domains/bulk_search

Accept: application/json

Authorization: Bearer API_KEY

Response

{

code: "Integer",
message: "String",
data: {
- domain_result_list: [
  1. {
    - domain_name: "String",
    - available: "String"
    }
  ]
}

}

SUGGESTION_SEARCH Command

Support multi-thread

Support API Sandbox

If calling the suggestion_search command, the following parameters should be included:

Request Parameters Expand All

tlds String

comma separated list of tlds.
max_count Integer Optional

max number of suggestions.

Result Parameters Expand All

domain_list List

List of domain suggestions.

Api Request and Header

GET https://api.dynadot.com/restful/v1/domains/{domain_name}/suggestion_search

Accept: application/json

Authorization: Bearer API_KEY

Response

{

code: "Integer",
message: "String",
data: {
- domain_list: [
  1. "String"
  ]
}

}

REGISTER Command

Support multi-thread

Support API Sandbox

Require X-Signature

If calling the register command, the following parameters should be included:

Request Parameters Expand All

domain Object
The domain name.
Show Properties
- duration Integer
  
  The duration of domain.
- auth_code String Optional
  
  The authCode of domain, used only for transfer in action.
- registrant_contact_id Integer Optional
  
  The registrant contact id.
- admin_contact_id Integer Optional
  
  The admin contact id.
- tech_contact_id Integer Optional
  
  The tech contact id.
- billing_contact_id Integer Optional
  
  The billing contact id.
- registrant_contact Object Optional
  The registrant contact.
  
  Show Properties
  
  organization String
  
  The organization.
  
  name String
  
  The name of contact owner.
  
  email String
  
  The email address.
  
  phone_number String
  
  The phone number.
  
  phone_cc String
  
  The phone country code.
  
  fax_number String
  
  The fax number.
  
  fax_cc String
  
  The fax country code.
  
  address1 String
  
  The address1.
  
  address2 String
  
  The address2.
  
  city String
  
  The city.
  
  state String
  
  The state.
  
  zip String
  
  The zip.
  
  country String
  
  The country.
- admin_contact Object Optional
  The admin contact.
  
  Show Properties
  
  organization String
  
  The organization.
  
  name String
  
  The name of contact owner.
  
  email String
  
  The email address.
  
  phone_number String
  
  The phone number.
  
  phone_cc String
  
  The phone country code.
  
  fax_number String
  
  The fax number.
  
  fax_cc String
  
  The fax country code.
  
  address1 String
  
  The address1.
  
  address2 String
  
  The address2.
  
  city String
  
  The city.
  
  state String
  
  The state.
  
  zip String
  
  The zip.
  
  country String
  
  The country.
- tech_contact Object Optional
  The tech contact.
  
  Show Properties
  
  organization String
  
  The organization.
  
  name String
  
  The name of contact owner.
  
  email String
  
  The email address.
  
  phone_number String
  
  The phone number.
  
  phone_cc String
  
  The phone country code.
  
  fax_number String
  
  The fax number.
  
  fax_cc String
  
  The fax country code.
  
  address1 String
  
  The address1.
  
  address2 String
  
  The address2.
  
  city String
  
  The city.
  
  state String
  
  The state.
  
  zip String
  
  The zip.
  
  country String
  
  The country.
- billing_contact Object Optional
  The billing contact.
  
  Show Properties
  
  organization String
  
  The organization.
  
  name String
  
  The name of contact owner.
  
  email String
  
  The email address.
  
  phone_number String
  
  The phone number.
  
  phone_cc String
  
  The phone country code.
  
  fax_number String
  
  The fax number.
  
  fax_cc String
  
  The fax country code.
  
  address1 String
  
  The address1.
  
  address2 String
  
  The address2.
  
  city String
  
  The city.
  
  state String
  
  The state.
  
  zip String
  
  The zip.
  
  country String
  
  The country.
- customer_id Integer Optional
  
  The customer id field allows resellers to specify and label their own customer ID within the Dynadot system.
- name_server_list List Optional
  
  The name server list.
- privacy String
  
  Is the domain require privacy.
  Supported valuesoff, partial, full
currency String Optional

The currency.
Supported valuesusd, gbp, eur, inr, pln, zar, ltl, cny, cad, jpy, nzd, rub, aud, mxn, brl, idr, ars, cop, dkk, rsd, hkd, chf, aed, myr, ngn, kes, czk, btc, nok
register_premium Boolean Optional

If you're considering registering a premium domain.
coupon_code String Optional

The coupon code plan to be used in the order.

Result Parameters Expand All

domain_name String

The domain name.
expiration_date Long

The expiration date in timestamp.

Api Request and Header

POST https://api.dynadot.com/restful/v1/domains/{domain_name}/register

Content-Type: application/json

Accept: application/json

Authorization: Bearer API_KEY

X-Signature: {signature}

Request Body

{

domain: {
- duration: 0,
- auth_code: "String",
- registrant_contact_id: 0,
- admin_contact_id: 0,
- tech_contact_id: 0,
- billing_contact_id: 0,
- registrant_contact: {
  - organization: "String",
  - name: "String",
  - email: "String",
  - phone_number: "String",
  - phone_cc: "String",
  - fax_number: "String",
  - fax_cc: "String",
  - address1: "String",
  - address2: "String",
  - city: "String",
  - state: "String",
  - zip: "String",
  - country: "String"
  13 items},
- admin_contact: {
  - organization: "String",
  - name: "String",
  - email: "String",
  - phone_number: "String",
  - phone_cc: "String",
  - fax_number: "String",
  - fax_cc: "String",
  - address1: "String",
  - address2: "String",
  - city: "String",
  - state: "String",
  - zip: "String",
  - country: "String"
  13 items},
- tech_contact: {
  - organization: "String",
  - name: "String",
  - email: "String",
  - phone_number: "String",
  - phone_cc: "String",
  - fax_number: "String",
  - fax_cc: "String",
  - address1: "String",
  - address2: "String",
  - city: "String",
  - state: "String",
  - zip: "String",
  - country: "String"
  13 items},
- billing_contact: {
  - organization: "String",
  - name: "String",
  - email: "String",
  - phone_number: "String",
  - phone_cc: "String",
  - fax_number: "String",
  - fax_cc: "String",
  - address1: "String",
  - address2: "String",
  - city: "String",
  - state: "String",
  - zip: "String",
  - country: "String"
  13 items},
- customer_id: 0,
- name_server_list: [
  1. "String"
  1 item],
- privacy: "String"
13 items},
currency: "String",
register_premium: false,
coupon_code: "String"

}

Response

{

code: "Integer",
message: "String",
data: {
- domain_name: "String",
- expiration_date: "Long"
}

}

RENEW Command

Support multi-thread

Support API Sandbox

Require X-Signature

If calling the renew command, the following parameters should be included:

Request Parameters Expand All

duration Integer

renewal duration in years.
year Integer

year to renew.
currency String Optional

The currency you would like to use for the purchase.
Supported valuesusd, gbp, eur, inr, pln, zar, ltl, cny, cad, jpy, nzd, rub, aud, mxn, brl, idr, ars, cop, dkk, rsd, hkd, chf, aed, myr, ngn, kes, czk, btc, nok
coupon String Optional

coupon code.
no_renew_if_late_renew_fee_needed Boolean Optional

Do not renew if late renew fee needed.

Result Parameters Expand All

expiration_date Long

expiration date of the domain.

Api Request and Header

POST https://api.dynadot.com/restful/v1/domains/{domain_name}/renew

Content-Type: application/json

Accept: application/json

Authorization: Bearer API_KEY

X-Signature: {signature}

Request Body

{

duration: 0,
year: 0,
currency: "String",
coupon: "String",
no_renew_if_late_renew_fee_needed: false

}

Response

{

code: "Integer",
message: "String",
data: {
- expiration_date: "Long"
}

}

TRANSFER_IN Command

Support multi-thread

Support API Sandbox

Require X-Signature

If calling the transfer_in command, the following parameters should be included:

Request Parameters Expand All

domain Object
The domain name.
Show Properties
- duration Integer
  
  The duration of domain.
- auth_code String Optional
  
  The authCode of domain, used only for transfer in action.
- registrant_contact_id Integer Optional
  
  The registrant contact id.
- admin_contact_id Integer Optional
  
  The admin contact id.
- tech_contact_id Integer Optional
  
  The tech contact id.
- billing_contact_id Integer Optional
  
  The billing contact id.
- registrant_contact Object Optional
  The registrant contact.
  
  Show Properties
  
  organization String
  
  The organization.
  
  name String
  
  The name of contact owner.
  
  email String
  
  The email address.
  
  phone_number String
  
  The phone number.
  
  phone_cc String
  
  The phone country code.
  
  fax_number String
  
  The fax number.
  
  fax_cc String
  
  The fax country code.
  
  address1 String
  
  The address1.
  
  address2 String
  
  The address2.
  
  city String
  
  The city.
  
  state String
  
  The state.
  
  zip String
  
  The zip.
  
  country String
  
  The country.
- admin_contact Object Optional
  The admin contact.
  
  Show Properties
  
  organization String
  
  The organization.
  
  name String
  
  The name of contact owner.
  
  email String
  
  The email address.
  
  phone_number String
  
  The phone number.
  
  phone_cc String
  
  The phone country code.
  
  fax_number String
  
  The fax number.
  
  fax_cc String
  
  The fax country code.
  
  address1 String
  
  The address1.
  
  address2 String
  
  The address2.
  
  city String
  
  The city.
  
  state String
  
  The state.
  
  zip String
  
  The zip.
  
  country String
  
  The country.
- tech_contact Object Optional
  The tech contact.
  
  Show Properties
  
  organization String
  
  The organization.
  
  name String
  
  The name of contact owner.
  
  email String
  
  The email address.
  
  phone_number String
  
  The phone number.
  
  phone_cc String
  
  The phone country code.
  
  fax_number String
  
  The fax number.
  
  fax_cc String
  
  The fax country code.
  
  address1 String
  
  The address1.
  
  address2 String
  
  The address2.
  
  city String
  
  The city.
  
  state String
  
  The state.
  
  zip String
  
  The zip.
  
  country String
  
  The country.
- billing_contact Object Optional
  The billing contact.
  
  Show Properties
  
  organization String
  
  The organization.
  
  name String
  
  The name of contact owner.
  
  email String
  
  The email address.
  
  phone_number String
  
  The phone number.
  
  phone_cc String
  
  The phone country code.
  
  fax_number String
  
  The fax number.
  
  fax_cc String
  
  The fax country code.
  
  address1 String
  
  The address1.
  
  address2 String
  
  The address2.
  
  city String
  
  The city.
  
  state String
  
  The state.
  
  zip String
  
  The zip.
  
  country String
  
  The country.
- customer_id Integer Optional
  
  The customer id field allows resellers to specify and label their own customer ID within the Dynadot system.
- name_server_list List Optional
  
  The name server list.
- privacy String
  
  Is the domain require privacy.
  Supported valuesoff, partial, full
currency String Optional

The currency.
Supported valuesusd, gbp, eur, inr, pln, zar, ltl, cny, cad, jpy, nzd, rub, aud, mxn, brl, idr, ars, cop, dkk, rsd, hkd, chf, aed, myr, ngn, kes, czk, btc, nok
transfer_premium Boolean Optional

If you're considering transfer a premium domain.
coupon_code String Optional

The coupon code plan to be used in the order.

Api Request and Header

POST https://api.dynadot.com/restful/v1/domains/{domain_name}/transfer_in

Content-Type: application/json

Accept: application/json

Authorization: Bearer API_KEY

X-Signature: {signature}

Request Body

{

domain: {
- duration: 0,
- auth_code: "String",
- registrant_contact_id: 0,
- admin_contact_id: 0,
- tech_contact_id: 0,
- billing_contact_id: 0,
- registrant_contact: {
  - organization: "String",
  - name: "String",
  - email: "String",
  - phone_number: "String",
  - phone_cc: "String",
  - fax_number: "String",
  - fax_cc: "String",
  - address1: "String",
  - address2: "String",
  - city: "String",
  - state: "String",
  - zip: "String",
  - country: "String"
  13 items},
- admin_contact: {
  - organization: "String",
  - name: "String",
  - email: "String",
  - phone_number: "String",
  - phone_cc: "String",
  - fax_number: "String",
  - fax_cc: "String",
  - address1: "String",
  - address2: "String",
  - city: "String",
  - state: "String",
  - zip: "String",
  - country: "String"
  13 items},
- tech_contact: {
  - organization: "String",
  - name: "String",
  - email: "String",
  - phone_number: "String",
  - phone_cc: "String",
  - fax_number: "String",
  - fax_cc: "String",
  - address1: "String",
  - address2: "String",
  - city: "String",
  - state: "String",
  - zip: "String",
  - country: "String"
  13 items},
- billing_contact: {
  - organization: "String",
  - name: "String",
  - email: "String",
  - phone_number: "String",
  - phone_cc: "String",
  - fax_number: "String",
  - fax_cc: "String",
  - address1: "String",
  - address2: "String",
  - city: "String",
  - state: "String",
  - zip: "String",
  - country: "String"
  13 items},
- customer_id: 0,
- name_server_list: [
  1. "String"
  1 item],
- privacy: "String"
13 items},
currency: "String",
transfer_premium: false,
coupon_code: "String"

}

Response

{

code: "Integer",
message: "String"

}

RESTORE Command

Support multi-thread

Support API Sandbox

Require X-Signature

If calling the restore command, the following parameters should be included:

Request Parameters Expand All

currency String Optional

The currency.
Supported valuesusd, gbp, eur, inr, pln, zar, ltl, cny, cad, jpy, nzd, rub, aud, mxn, brl, idr, ars, cop, dkk, rsd, hkd, chf, aed, myr, ngn, kes, czk, btc, nok
coupon_code String Optional

The coupon code plan to be used in the order.

Api Request and Header

POST https://api.dynadot.com/restful/v1/domains/{domain_name}/restore

Content-Type: application/json

Accept: application/json

Authorization: Bearer API_KEY

X-Signature: {signature}

Request Body

{

currency: "String",
coupon_code: "String"

}

Response

{

code: "Integer",
message: "String"

}

GRACE_DELETE Command

Support multi-thread

Support API Sandbox

Require X-Signature

If calling the grace_delete command, the following parameters should be included:

Request Parameters Expand All

add_to_waiting_list Boolean Optional

If need to add this domain to grace delete waiting list if the grace delete quota has been reached.

Api Request and Header

DELETE https://api.dynadot.com/restful/v1/domains/{domain_name}/grace_delete

Content-Type: application/json

Accept: application/json

Authorization: Bearer API_KEY

X-Signature: {signature}

Response

{

code: "Integer",
message: "String"

}

SET_FOLDER Command

Support multi-thread

Support API Sandbox

Require X-Signature

If calling the set_folder command, the following parameters should be included:

Request Parameters Expand All

Api Request and Header

PUT https://api.dynadot.com/restful/v1/domains/{domain_name}/folders/{folder_name}

Content-Type: application/json

Accept: application/json

Authorization: Bearer API_KEY

X-Signature: {signature}

Request Body

{}

Response

{

code: "Integer",
message: "String"

}

SET_DOMAIN_FORWARDING Command

Support multi-thread

Support API Sandbox

Require X-Signature

If calling the set_domain_forwarding command, the following parameters should be included:

Request Parameters Expand All

forward_url String

The URL you want your domain to forward to. Please note that the parameter must be encoded so that the API call is interpreted properly.
is_temporary Boolean Optional

Forward status of your domain you want, default value is "true", if you want to forward permanently, use this parameter with "false".

Api Request and Header

PUT https://api.dynadot.com/restful/v1/domains/{domain_name}/domain_forwarding

Content-Type: application/json

Accept: application/json

Authorization: Bearer API_KEY

X-Signature: {signature}

Request Body

{

forward_url: "String",
is_temporary: false

}

Response

{

code: "Integer",
message: "String"

}

SET_STEALTH_FORWARDING Command

Support multi-thread

Support API Sandbox

Require X-Signature

If calling the set_stealth_forwarding command, the following parameters should be included:

Request Parameters Expand All

stealth_url String

The URL you want your domain to forward to. Please note that the parameter must be encoded so that the API call is interpreted properly.
stealth_title String

The title of the page.

Api Request and Header

PUT https://api.dynadot.com/restful/v1/domains/{domain_name}/stealth_forwarding

Content-Type: application/json

Accept: application/json

Authorization: Bearer API_KEY

X-Signature: {signature}

Request Body

{

stealth_url: "String",
stealth_title: "String"

}

Response

{

code: "Integer",
message: "String"

}

SET_EMAIL_FORWARDING Command

Support multi-thread

Support API Sandbox

Require X-Signature

If calling the set_email_forwarding command, the following parameters should be included:

Request Parameters Expand All

forward_type String

Forward type, it can be "donot": Do not forward email, "mx": Deliver email to another mail host (MX record), "forward": Deliver email to another mail host.
Supported valuesnone, mx, forward
forward_detail_list List Optional
Only used when "forwardType" is "forward".
Show Properties
- username String
  
  The username of the target user for forwarding.
- email String
  
  The email address associated with the target user for receiving forwarded content.
mx_record_list List Optional
Only used when "forwardType" is "mx".
Show Properties
- host String
  
  The domain name of the mail server responsible for receiving emails.
- distance String
  
  The priority of the MX record, where smaller values indicate higher priority.

Api Request and Header

PUT https://api.dynadot.com/restful/v1/domains/{domain_name}/email_forwarding

Content-Type: application/json

Accept: application/json

Authorization: Bearer API_KEY

X-Signature: {signature}

Request Body

{

forward_type: "String",
forward_detail_list: [
1. {
  - username: "String",
  - email: "String"
  2 items}
1 item],
mx_record_list: [
1. {
  - host: "String",
  - distance: "String"
  2 items}
1 item]

}

Response

{

code: "Integer",
message: "String"

}

SET_RENEW_OPTION Command

Support multi-thread

Support API Sandbox

Require X-Signature

If calling the set_renew_option command, the following parameters should be included:

Request Parameters Expand All

renew_option String

You can choose a value from the following list to represent.
Supported valuesreset, auto, donot

Api Request and Header

PUT https://api.dynadot.com/restful/v1/domains/{domain_name}/renew_option

Content-Type: application/json

Accept: application/json

Authorization: Bearer API_KEY

X-Signature: {signature}

Request Body

{

renew_option: "String"

}

Response

{

code: "Integer",
message: "String"

}

SET_CONTACTS Command

Support multi-thread

Support API Sandbox

Require X-Signature

If calling the set_contacts command, the following parameters should be included:

Request Parameters Expand All

registrant_contact_id Integer

Please select the contact ID you want to set as the registered contact ID.
admin_contact_id Integer

Please select the contact ID you want to set as the admin contact ID.
technical_contact_id Integer

Please select the contact ID you want to set as the technical contact ID.
billing_contact_id Integer

Please select the contact ID you want to set as the billing contact ID.

Api Request and Header

PUT https://api.dynadot.com/restful/v1/domains/{domain_name}/contacts

Content-Type: application/json

Accept: application/json

Authorization: Bearer API_KEY

X-Signature: {signature}

Request Body

{

registrant_contact_id: 0,
admin_contact_id: 0,
technical_contact_id: 0,
billing_contact_id: 0

}

Response

{

code: "Integer",
message: "String"

}

GET_TRANSFER_STATUS Command

Support multi-thread

Support API Sandbox

If calling the get_transfer_status command, the following parameters should be included:

Request Parameters Expand All

transfer_type String

The transfer type you want to get transfer status.
Supported valuestransfer_in, transfer_away

Result Parameters Expand All

domain_transfer_status_list List
The domain transfer status list information.
Show Properties
- order_id String
  
  The order ID of the transfer.
- transfer_status String
  
  The status of the transfer.
- failed_reason String
  
  The reason of the failure.
- expiration_date Long
  
  The expiration time of the transfer.

Api Request and Header

GET https://api.dynadot.com/restful/v1/domains/{domain_name}/transfer_status

Accept: application/json

Authorization: Bearer API_KEY

Response

{

code: "Integer",
message: "String",
data: {
- domain_transfer_status_list: [
  1. {
    - order_id: "String",
    - transfer_status: "String"
    }
  ]
}

}

DOMAIN_GET_NAMESERVER Command

Support multi-thread

Support API Sandbox

If calling the domain_get_nameserver command, the following parameters should be included:

Request Parameters Expand All

Result Parameters Expand All

nameserver_list List

The list of nameservers for the domain.
name_servers String

The name of the nameserver.

Api Request and Header

GET https://api.dynadot.com/restful/v1/domains/{domain_name}/nameservers

Accept: application/json

Authorization: Bearer API_KEY

Response

{

code: "Integer",
message: "String",
data: {
- name_servers: [
  1. {
    - host: "String",
    - ns_name: "String"
    }
  ]
}

}

DOMAIN_SET_NAMESERVER Command

Support multi-thread

Support API Sandbox

Require X-Signature

If calling the domain_set_nameserver command, the following parameters should be included:

Request Parameters Expand All

nameserver_list List

The list of nameservers you want to set.

Api Request and Header

PUT https://api.dynadot.com/restful/v1/domains/{domain_name}/nameservers

Content-Type: application/json

Accept: application/json

Authorization: Bearer API_KEY

X-Signature: {signature}

Request Body

{

nameserver_list: [
1. "String"
1 item]

}

Response

{

code: "Integer",
message: "String"

}

SET_HOSTING Command

Support multi-thread

Support API Sandbox

Require X-Signature

If calling the set_hosting command, the following parameters should be included:

Request Parameters Expand All

hosting_type String

Type of the hosting you want, you can select in "Advanced" and "Basic".
Supported valuesbasic, advanced
is_model_view Boolean

Only when hostingType is "advanced", can you use this parameter as "true".

Api Request and Header

PUT https://api.dynadot.com/restful/v1/domains/{domain_name}/hosts

Content-Type: application/json

Accept: application/json

Authorization: Bearer API_KEY

X-Signature: {signature}

Request Body

{

hosting_type: "String",
is_model_view: false

}

Response

{

code: "Integer",
message: "String"

}

SET_PARKING Command

Support multi-thread

Support API Sandbox

Require X-Signature

If calling the set_parking command, the following parameters should be included:

Request Parameters Expand All

with_ads Boolean Optional

If you do not want a 3rd-party ads, you can use this parameter with "false".

Api Request and Header

PUT https://api.dynadot.com/restful/v1/domains/{domain_name}/parking

Content-Type: application/json

Accept: application/json

Authorization: Bearer API_KEY

X-Signature: {signature}

Request Body

{

with_ads: false

}

Response

{

code: "Integer",
message: "String"

}

SET_PRIVACY Command

Support multi-thread

Support API Sandbox

Require X-Signature

If calling the set_privacy command, the following parameters should be included:

Request Parameters Expand All

privacy_level String

The privacy status of the domain you want to set.
Supported valuesoff, partial, full
whois_privacy_option Boolean

The whois privacy option of the domain you want to set.

Api Request and Header

PUT https://api.dynadot.com/restful/v1/domains/{domain_name}/privacy

Content-Type: application/json

Accept: application/json

Authorization: Bearer API_KEY

X-Signature: {signature}

Request Body

{

privacy_level: "String",
whois_privacy_option: false

}

Response

{

code: "Integer",
message: "String"

}

SET_DNSSEC Command

Support multi-thread

Support API Sandbox

Require X-Signature

If calling the set_dnssec command, the following parameters should be included:

Request Parameters Expand All

key_tag Integer Optional

The key tag is a 16-bit unsigned integer (0 - 65535) used to uniquely identify a DNSSEC key pair. It ensures DS records match their corresponding DNS KEY records during DNSSEC validation.
digest_type String Optional

You can choose the digest_type type listed below.
Supported valuessha1, sha256, gost, sha384
digest String Optional

Please enter the value corresponding to the digest type you have selected.
algorithm String

You can choose the type of algorithm listed below.
Supported valuesrsa_md5, diffie_hellman, dsa_sha1, elliptic_curve, rsa_sha1, dsa_nsec3_sha1, rsa_sha1_nsec3_sha1, rsa_sha256, rsa_sha512, gost, ecdsa_p256_sha256, ecdsa_p384_sha384, ed25519, ed448, indirect, private_dns, private_oid
flags String Optional

You can choose the type of flags listed below.
Supported valueszsk, ksk
public_key String Optional

The public key must be in base64 encoding.

Api Request and Header

PUT https://api.dynadot.com/restful/v1/domains/{domain_name}/dnssec

Content-Type: application/json

Accept: application/json

Authorization: Bearer API_KEY

X-Signature: {signature}

Request Body

{

key_tag: 0,
digest_type: "String",
digest: "String",
algorithm: "String",
flags: "String",
public_key: "String"

}

Response

{

code: "Integer",
message: "String"

}

GET_DNSSEC Command

Support multi-thread

Support API Sandbox

If calling the get_dnssec command, the following parameters should be included:

Request Parameters Expand All

Result Parameters Expand All

dnssec_info_list List
dnssecInfoList.
Show Properties
- key_tag Integer
  
  The key tag of the DNSSEC record.
- algorithm String
  
  The algorithm of the DNSSEC record.
- digest_type String
  
  The digest type of the DNSSEC record.
- digest String
  
  The digest of the DNSSEC record.

Api Request and Header

GET https://api.dynadot.com/restful/v1/domains/{domain_name}/dnssec

Accept: application/json

Authorization: Bearer API_KEY

Response

{

code: "Integer",
message: "String",
data: {
- dnssec_info_list: [
  1. {
    - key_tag: "Integer",
    - algorithm: "String",
    - digest_type: "String",
    - digest: "String"
    }
  ]
}

}

CLEAR_DNSSEC Command

Support multi-thread

Support API Sandbox

Require X-Signature

If calling the clear_dnssec command, the following parameters should be included:

Request Parameters Expand All

Api Request and Header

DELETE https://api.dynadot.com/restful/v1/domains/{domain_name}/dnssec

Content-Type: application/json

Accept: application/json

Authorization: Bearer API_KEY

X-Signature: {signature}

Response

{

code: "Integer",
message: "String"

}

CLEAR_DOMAIN_SETTING Command

Support multi-thread

Support API Sandbox

Require X-Signature

If calling the clear_domain_setting command, the following parameters should be included:

Request Parameters Expand All

service_type String

The service you want to clear the domain settings for, you can enter forward, stealth, email_forwarding, free, dns, nameservers.
Supported valuesforward, stealth, email_forwarding, dns, nameservers

Api Request and Header

PUT https://api.dynadot.com/restful/v1/domains/{domain_name}/clear_domain_setting

Content-Type: application/json

Accept: application/json

Authorization: Bearer API_KEY

X-Signature: {signature}

Request Body

{

service_type: "String"

}

Response

{

code: "Integer",
message: "String"

}

SET_DOMAIN_LOCK_STATUS Command

Support multi-thread

Support API Sandbox

Require X-Signature

If calling the set_domain_lock_status command, the following parameters should be included:

Request Parameters Expand All

lock Boolean

Set to true to lock the domain, false to unlock the domain.

Api Request and Header

PUT https://api.dynadot.com/restful/v1/domains/{domain_name}/domain_lock

Content-Type: application/json

Accept: application/json

Authorization: Bearer API_KEY

X-Signature: {signature}

Request Body

{

lock: false

}

Response

{

code: "Integer",
message: "String"

}

PUSH Command

Support multi-thread

Support API Sandbox

Require X-Signature

If calling the push command, the following parameters should be included:

Request Parameters Expand All

receiver_push_username String

The receiver's push username.
receiver_email String Optional

The receiver email.

Api Request and Header

POST https://api.dynadot.com/restful/v1/domains/{domain_name}/push

Content-Type: application/json

Accept: application/json

Authorization: Bearer API_KEY

X-Signature: {signature}

Request Body

{

receiver_push_username: "String",
receiver_email: "String"

}

Response

{

code: "Integer",
message: "String"

}

ACCEPT_PUSH Command

Support multi-thread

Support API Sandbox

Require X-Signature

If calling the accept_push command, the following parameters should be included:

Request Parameters Expand All

push_action String

The action of the order to be processed.
Supported valuesaccept, decline

Api Request and Header

POST https://api.dynadot.com/restful/v1/domains/{domain_name}/accept_push

Content-Type: application/json

Accept: application/json

Authorization: Bearer API_KEY

X-Signature: {signature}

Request Body

{

push_action: "String"

}

Response

{

code: "Integer",
message: "String"

}

GET_PENDING_PUSH_ACCEPT_REQUEST Command

Support multi-thread

Support API Sandbox

Require X-Signature

If calling the get_pending_push_accept_request command, the following parameters should be included:

Request Parameters Expand All

Result Parameters Expand All

domain_name_list List

List of domain names.

Api Request and Header

GET https://api.dynadot.com/restful/v1/domains/pending_accept_pushes

Accept: application/json

Authorization: Bearer API_KEY

X-Signature: {signature}

Response

{

code: "Integer",
message: "String",
data: {
- domain_name_list: [
  1. "String"
  ]
}

}

GET_DNS Command

Support multi-thread

Support API Sandbox

Require X-Signature

If calling the get_dns command, the following parameters should be included:

Request Parameters Expand All

Result Parameters Expand All

name_server_settings Object
The dns setting of the domain.
Show Properties
- glue_type String
  
  The type of the nameserver.
  Supported valuestype_null, type_park, type_dns, type_user, type_forward, type_stealth, type_webhost_basic, type_dynasite, type_webhost_advanced, type_free_webhost, type_sitebuilder, type_forsale, type_reseller_storefront, type_park_bot
- nameservers List
  The nameservers.
  
  Show Properties
  
  server_name String
  
  The name of the nameserver.
  
  ip_list List
  
  The IP list of the nameserver.
- with_ads String
  
  The status of the ads.
- forward_to String
  
  The forward to.
- forward_type String
  
  The forward type.
- website_title String
  
  The title of the website.
- email_forward_type String
  
  The email forwarding settings.
  Supported valuesmtype_none, mtype_forward, mtype_mx
- mail_exchanges List
  The mail exchanges.
  
  Show Properties
  
  host String
  
  Mail host, only used when forward type is mx, only used when "forward_type" is "mx".
  
  distance String
  
  Distance is the highest priority, only used when "forward_type" is "mx".
- email_alias_list List
  The email alias list.
  
  Show Properties
  
  username String
  
  The user name of the email alias, only used when "forward_type" is "forward".
  
  to_email String
  
  The email address of the email alias, only used when "forward_type" is "forward".
- dns_main_list List
  The dns main list.
  
  Show Properties
  
  record_type String
  
  The type of the record.
  Supported valuesa, cname, forward, aaaa, txt, stealth, mx, email, caa, aname, srv, ns
  
  record_value1 String
  
  The value of the record.
  
  record_value2 String
  
  The second value of the record.
- dns_sub_list List
  The dns sub list.
  
  Show Properties
  
  sub_host String
  
  The subhost of the DNS record.
  
  record_type String
  
  The record type of the DNS record.
  Supported valuesa, cname, forward, aaaa, txt, stealth, mx, email, caa, aname, srv, ns
  
  record_value1 String
  
  The value of the DNS record.
  
  record_value2 String
  
  The second value of the DNS record.
- ttl String
  
  The time to live.

Api Request and Header

GET https://api.dynadot.com/restful/v1/domains/{domain_name}/records

Accept: application/json

Authorization: Bearer API_KEY

X-Signature: {signature}

Response

{

code: "Integer",
message: "String",
data: {
- name_server_settings: {
  - type: "String",
  - with_ads: "String"
  }
}

}

SET_DNS Command

Support multi-thread

Support API Sandbox

Require X-Signature

If calling the set_dns command, the following parameters should be included:

Request Parameters Expand All

dns_main_list List
List of main DNS records, max 20.
Show Properties
- record_type String Optional
  
  The type of the record.
  Supported valuesa, cname, forward, aaaa, txt, stealth, mx, email, caa, aname, srv, ns
- record_value1 String Optional
  
  The value of the record.
- record_value2 String Optional
  
  The second value of the record.
sub_list List Optional
List of sub DNS records, max 100.
Show Properties
- sub_host String Optional
  
  The subhost of the DNS record.
- record_type String Optional
  
  The record type of the DNS record.
  Supported valuesa, cname, forward, aaaa, txt, stealth, mx, email, caa, aname, srv, ns
- record_value1 String Optional
  
  The value of the DNS record.
- record_value2 String Optional
  
  The second value of the DNS record.
ttl Long Optional

Time to live for DNS records, default is 86400.
add_dns_to_current_setting Boolean Optional

Add DNS records to current settings, default is false.

Api Request and Header

POST https://api.dynadot.com/restful/v1/domains/{domain_name}/records

Content-Type: application/json

Accept: application/json

Authorization: Bearer API_KEY

X-Signature: {signature}

Request Body

{

dns_main_list: [
1. {
  - record_type: "String",
  - record_value1: "String",
  - record_value2: "String"
  3 items}
1 item],
sub_list: [
1. {
  - sub_host: "String",
  - record_type: "String",
  - record_value1: "String",
  - record_value2: "String"
  4 items}
1 item],
ttl: 0,
add_dns_to_current_setting: false

}

Response

{

code: "Integer",
message: "String"

}

SET_NOTE Command

Support multi-thread

Support API Sandbox

Require X-Signature

If calling the set_note command, the following parameters should be included:

Request Parameters Expand All

note String

this domain's note.

Api Request and Header

PUT https://api.dynadot.com/restful/v1/domains/{domain_name}/notes

Content-Type: application/json

Accept: application/json

Authorization: Bearer API_KEY

X-Signature: {signature}

Request Body

{

note: "String"

}

Response

{

code: "Integer",
message: "String"

}

GET_TRANSFER_AUTH_CODE Command

Support multi-thread

Support API Sandbox

Require X-Signature

If calling the get_transfer_auth_code command, the following parameters should be included:

Request Parameters Expand All

new_code Boolean Optional

Set to true if you want to generate a new auth code.
unlock_domain_for_transfer Boolean Optional

Set to true if you want to unlock the domain for transfer.

Result Parameters Expand All

auth_code String

The transfer auth code.

Api Request and Header

GET https://api.dynadot.com/restful/v1/domains/{domain_name}/transfer_auth_code

Accept: application/json

Authorization: Bearer API_KEY

X-Signature: {signature}

Response

{

code: "Integer",
message: "String",
data: {
- auth_code: "String"
}

}

DOMAIN_GET_TLD_PRICE Command

Support multi-thread

Support API Sandbox

If calling the domain_get_tld_price command, the following parameters should be included:

Request Parameters Expand All

currency String

The currency you would like to use for the search.
Supported valuesusd, gbp, eur, inr, pln, zar, ltl, cny, cad, jpy, nzd, rub, aud, mxn, brl, idr, ars, cop, dkk, rsd, hkd, chf, aed, myr, ngn, kes, czk, btc, nok
page_index Integer Optional

The page index.
count_per_page Integer Optional

The count per page.
sort String Optional

The sort : name_asc, name_desc, etc.
Supported valuesrank_asc, rank_desc, name_asc, name_desc, sales_asc, sales_desc, launch_date_asc, launch_date_desc, count_asc, count_desc, registry_asc, registry_desc
show_multi_year Boolean Optional

Whether to show multi-year prices.

Result Parameters Expand All

page_index Integer

The page index.
count_per_page Integer

The count per page.
sort String

The sort : name_asc, name_desc, etc.
Supported valuesrank_asc, rank_desc, name_asc, name_desc, sales_asc, sales_desc, launch_date_asc, launch_date_desc, count_asc, count_desc, registry_asc, registry_desc
price_level String

The price level.
currency String

The currency you would like to use for the search.
show_multi_year_price Boolean

Whether to show multi-year prices.
tld_price_list List
The list of TLD prices.
Show Properties
- tld String
  
  The TLD.
- usage String
  
  The usage.
- price_unit String
  
  The price unit.
- all_years_register_price List
  
  The price for all years registration.
- all_years_renew_price List
  
  The price for all years renewal.
- transfer_price String
  
  The transfer price.
- restore_price String
  
  The restore price.
- grace_fee_price String
  
  The grace fee price.
- support_privacy String
  
  The support privacy.
- grace_period_unit String
  
  The grace period unit.
- renew_grace_period String
  
  The renew grace period.
- restore_period String
  
  The restore period.
- delete_grace_period String
  
  The delete grace period.
- is_idn String
  
  The IDN.
- restriction String
  
  The restriction.
- on_sale String
  
  The onSale.

Api Request and Header

GET https://api.dynadot.com/restful/v1/domains/get_tld_price

Accept: application/json

Authorization: Bearer API_KEY

Response

{

code: "Integer",
message: "String",
data: {
- page_index: "Integer",
- count_per_page: "Integer",
- sort: "String",
- price_level: "String",
- currency: "String",
- show_multi_year_price: "String",
- tldPriceList: [
  1. {
    - tld: "String",
    - usage: "String",
    - priceUnit: "String",
    - allYearsRegisterPrice: [],
    - allYearsRenewPrice: [],
    - transferPrice: "String",
    - restorePrice: "String",
    - graceFeePrice: "String",
    - supportPrivacy: "String",
    - gracePeriodUnit: "String",
    - renewGracePeriod: "String",
    - restorePeriod: "String",
    - deleteGracePeriod: "String",
    - isIdn: "String",
    - restriction: "String",
    - onSale: "String"
    }
  ]
}

}

DOMAIN_LIST Command

Support multi-thread

Support API Sandbox

If calling the domain_list command, the following parameters should be included:

Request Parameters Expand All

sort String Optional

The sort type.
Supported valuescount_asc, count_desc, name_asc, name_desc
count_per_page Integer Optional

The count per page.
page_index Integer Optional

The page index.
status String Optional
The domain status, default is active.
Supported values
- all : { all }
- active : { active }
- deleted_grace : { deleted grace }
- transferaway : { transferaway }
- expired : { expired }
- moved_pull : { moved (pull) }
- deleted_by_cust : { deleted by cust }
- deleted_by_admin : { deleted by admin }
- moved_push : { moved (push) }
- tag_released : { tag released }
- moved_expired_auction : { moved (expired auction) }
- moved_sold : { moved (sold) }
- deleted_by_registry : { deleted by registry }
- moved_user_auction : { moved (user auction) }
- transferaway_expired_auction : { transferaway (expired auction) }
- transferaway_user_auction : { transferaway (user auction) }
- transferaway_listing : { transferaway (listing) }
- moved_last_chance_auction : { moved (last chance auction) }
- expired_pull : { expired (pull) }
- installment_push_back_to_seller : { installment (push back to seller) }
- moved_portfolio_auction : { moved (portfolio auction) }
- moved_registry_auction : { moved (registry auction) }
- installment_reverse_push_back_to_seller : { installment (reverse push back to seller) }
- expired_auction : { expired (auction) }

Result Parameters Expand All

domain_info List
The domain list.
Show Properties
- domain_name String
  
  Domain name.
- expiration Long
  
  Expiration date.
- registration Long
  
  Registration date.
- glue_info Object
  Glue information.
  
  Show Properties
  
  glue_type String
  
  The type of the nameserver.
  Supported valuestype_null, type_park, type_dns, type_user, type_forward, type_stealth, type_webhost_basic, type_dynasite, type_webhost_advanced, type_free_webhost, type_sitebuilder, type_forsale, type_reseller_storefront, type_park_bot
  
  nameservers List
  
  The nameservers.
  
  Show Properties
  
  server_name String Optional
  
  The name of the nameserver.
  
  ip_list List Optional
  
  The IP list of the nameserver.
  
  with_ads String
  
  The status of the ads.
  
  forward_to String
  
  The forward to.
  
  forward_type String
  
  The forward type.
  
  website_title String
  
  The title of the website.
  
  email_forward_type String
  
  The email forwarding settings.
  Supported valuesmtype_none, mtype_forward, mtype_mx
  
  mail_exchanges List
  
  The mail exchanges.
  
  Show Properties
  
  host String Optional
  
  Mail host, only used when forward type is mx, only used when "forward_type" is "mx".
  
  distance String Optional
  
  Distance is the highest priority, only used when "forward_type" is "mx".
  
  email_alias_list List
  
  The email alias list.
  
  Show Properties
  
  username String Optional
  
  The user name of the email alias, only used when "forward_type" is "forward".
  
  to_email String Optional
  
  The email address of the email alias, only used when "forward_type" is "forward".
  
  dns_main_list List
  
  The dns main list.
  
  Show Properties
  
  record_type String Optional
  
  The type of the record.
  Supported valuesa, cname, forward, aaaa, txt, stealth, mx, email, caa, aname, srv, ns
  
  record_value1 String Optional
  
  The value of the record.
  
  record_value2 String Optional
  
  The second value of the record.
  
  dns_sub_list List
  
  The dns sub list.
  
  Show Properties
  
  sub_host String Optional
  
  The subhost of the DNS record.
  
  record_type String Optional
  
  The record type of the DNS record.
  Supported valuesa, cname, forward, aaaa, txt, stealth, mx, email, caa, aname, srv, ns
  
  record_value1 String Optional
  
  The value of the DNS record.
  
  record_value2 String Optional
  
  The second value of the DNS record.
  
  ttl String
  
  The time to live.
- registrant_contact_id Integer
  
  Registrar contact ID.
- admin_contact_id Integer
  
  Admin contact ID.
- tech_contact_id Integer
  
  Tech contact ID.
- billing_contact_id Integer
  
  Billing contact ID.
- locked Boolean
  
  Domain locked status.
- disabled Boolean
  
  Domain disabled status.
- udrp_locked Boolean
  
  UDRP locked status.
- registrant_unverified Boolean
  
  Registrant unverified status.
- hold Boolean
  
  Client/Registrar Hold Status.
- privacy String
  
  Privacy status.
- is_for_sale Boolean
  
  Is for sale status.
- renew_option String
  
  Renew option.
- note String
  
  Note.
- folder_id Integer
  
  Folder ID.
- folder_name String
  
  Folder name.
- status String
  
  Domain status. for example: active, deleted grace, transferaway, expired, moved (pull), deleted by cust, deleted by admin, moved (push), tag released, moved (expired auction), moved (sold), deleted by registry, moved (user auction), transferaway (expired auction), transferaway (user auction), transferaway (listing), moved (last chance auction), expired (pull), installment (push back to seller), moved (portfolio auction), moved (registry auction), installment (reverse push back to seller), expired (auction).

Api Request and Header

GET https://api.dynadot.com/restful/v1/domains

Accept: application/json

Authorization: Bearer API_KEY

Response

{

code: "Integer",
message: "String",
data: {
- domainInfo: [
  1. {
    - domainName: "String",
    - expiration: "Long",
    - registration: "Long",
    - glueInfo: {
      - name_server_settings: {
        type: "String",
        with_ads: "String",
        forward_to: "String",
        forward_type: "String",
        website_title: "String",
        ttl: "String",
        email_forwarding: {
        type: "String"
        }
        }
      },
    - registrant_contactId: "Integer",
    - admin_contactId: "Integer",
    - tech_contactId: "Integer",
    - billing_contactId: "Integer",
    - locked: "String",
    - disabled: "String",
    - udrpLocked: "String",
    - registrant_unverified: "String",
    - hold: "String",
    - privacy: "String",
    - is_for_sale: "String",
    - renew_option: "String",
    - note: "String",
    - folder_id: "Integer",
    - folder_name: "String",
    - status: "String"
    }
  ]
}

}

DOMAIN_INFO Command

Support multi-thread

Support API Sandbox

If calling the domain_info command, the following parameters should be included:

Request Parameters Expand All

Result Parameters Expand All

domain_info Object
The domain info.
Show Properties
- domain_name String
  
  Domain name.
- expiration Long
  
  Expiration date.
- registration Long
  
  Registration date.
- glue_info Object
  Glue information.
  
  Show Properties
  
  glue_type String
  
  The type of the nameserver.
  Supported valuestype_null, type_park, type_dns, type_user, type_forward, type_stealth, type_webhost_basic, type_dynasite, type_webhost_advanced, type_free_webhost, type_sitebuilder, type_forsale, type_reseller_storefront, type_park_bot
  
  nameservers List
  
  The nameservers.
  
  Show Properties
  
  server_name String Optional
  
  The name of the nameserver.
  
  ip_list List Optional
  
  The IP list of the nameserver.
  
  with_ads String
  
  The status of the ads.
  
  forward_to String
  
  The forward to.
  
  forward_type String
  
  The forward type.
  
  website_title String
  
  The title of the website.
  
  email_forward_type String
  
  The email forwarding settings.
  Supported valuesmtype_none, mtype_forward, mtype_mx
  
  mail_exchanges List
  
  The mail exchanges.
  
  Show Properties
  
  host String Optional
  
  Mail host, only used when forward type is mx, only used when "forward_type" is "mx".
  
  distance String Optional
  
  Distance is the highest priority, only used when "forward_type" is "mx".
  
  email_alias_list List
  
  The email alias list.
  
  Show Properties
  
  username String Optional
  
  The user name of the email alias, only used when "forward_type" is "forward".
  
  to_email String Optional
  
  The email address of the email alias, only used when "forward_type" is "forward".
  
  dns_main_list List
  
  The dns main list.
  
  Show Properties
  
  record_type String Optional
  
  The type of the record.
  Supported valuesa, cname, forward, aaaa, txt, stealth, mx, email, caa, aname, srv, ns
  
  record_value1 String Optional
  
  The value of the record.
  
  record_value2 String Optional
  
  The second value of the record.
  
  dns_sub_list List
  
  The dns sub list.
  
  Show Properties
  
  sub_host String Optional
  
  The subhost of the DNS record.
  
  record_type String Optional
  
  The record type of the DNS record.
  Supported valuesa, cname, forward, aaaa, txt, stealth, mx, email, caa, aname, srv, ns
  
  record_value1 String Optional
  
  The value of the DNS record.
  
  record_value2 String Optional
  
  The second value of the DNS record.
  
  ttl String
  
  The time to live.
- registrant_contact_id Integer
  
  Registrar contact ID.
- admin_contact_id Integer
  
  Admin contact ID.
- tech_contact_id Integer
  
  Tech contact ID.
- billing_contact_id Integer
  
  Billing contact ID.
- locked Boolean
  
  Domain locked status.
- disabled Boolean
  
  Domain disabled status.
- udrp_locked Boolean
  
  UDRP locked status.
- registrant_unverified Boolean
  
  Registrant unverified status.
- hold Boolean
  
  Client/Registrar Hold Status.
- privacy String
  
  Privacy status.
- is_for_sale Boolean
  
  Is for sale status.
- renew_option String
  
  Renew option.
- note String
  
  Note.
- folder_id Integer
  
  Folder ID.
- folder_name String
  
  Folder name.
- status String
  
  Domain status. for example: active, deleted grace, transferaway, expired, moved (pull), deleted by cust, deleted by admin, moved (push), tag released, moved (expired auction), moved (sold), deleted by registry, moved (user auction), transferaway (expired auction), transferaway (user auction), transferaway (listing), moved (last chance auction), expired (pull), installment (push back to seller), moved (portfolio auction), moved (registry auction), installment (reverse push back to seller), expired (auction).

Api Request and Header

GET https://api.dynadot.com/restful/v1/domains/{domain_name}

Accept: application/json

Authorization: Bearer API_KEY

Response

{

code: "Integer",
message: "String",
data: {
- domainInfo: [
  1. {
    - domainName: "String",
    - expiration: "Long",
    - registration: "Long",
    - glueInfo: {
      - name_server_settings: {
        type: "String",
        with_ads: "String",
        forward_to: "String",
        forward_type: "String",
        website_title: "String",
        ttl: "String",
        email_forwarding: {
        type: "String"
        }
        }
      },
    - registrant_contactId: "Integer",
    - admin_contactId: "Integer",
    - tech_contactId: "Integer",
    - billing_contactId: "Integer",
    - locked: "String",
    - disabled: "String",
    - udrpLocked: "String",
    - registrant_unverified: "String",
    - hold: "String",
    - privacy: "String",
    - is_for_sale: "String",
    - renew_option: "String",
    - note: "String",
    - folder_id: "Integer",
    - folder_name: "String",
    - status: "String"
    }
  ]
}

}

GET_CONTACT Command

Support multi-thread

Support API Sandbox

If calling the get_contact command, the following parameters should be included:

Request Parameters Expand All

Result Parameters Expand All

contact Object
The contact object.
Show Properties
- organization String
  
  The organization.
- name String
  
  The name of contact owner.
- email String
  
  The email address.
- phone_number String
  
  The phone number.
- phone_cc String
  
  The phone country code.
- fax_number String
  
  The fax number.
- fax_cc String
  
  The fax country code.
- address1 String
  
  The address1.
- address2 String
  
  The address2.
- city String
  
  The city.
- state String
  
  The state.
- zip String
  
  The zip.
- country String
  
  The country.

Api Request and Header

GET https://api.dynadot.com/restful/v1/contacts/{contact_id}

Accept: application/json

Authorization: Bearer API_KEY

Response

{

code: "Integer",
message: "String",
data: {
- organization: "String",
- name: "String",
- email: "String",
- phone_number: "String",
- phone_cc: "String",
- fax_number: "String",
- fax_cc: "String",
- address1: "String",
- address2: "String",
- city: "String",
- state: "String",
- zip: "String",
- country: "String"
}

}

CONTACT_LIST Command

Support multi-thread

Support API Sandbox

If calling the contact_list command, the following parameters should be included:

Request Parameters Expand All

whois_verification_status String Optional

Filter contacts by whois verification status.
Supported valuesnone, verified, verifying, unverified
count_per_page Integer Optional

Number of contacts to return per page.
page_index Integer Optional

Page index of the contacts to return.

Result Parameters Expand All

contact_list List
The list of contacts.
Show Properties
- contact_id Integer
  
  The contact_id.
- organization String
  
  The organization.
- name String
  
  The name of contact owner.
- email String
  
  The email address.
- phone_number String
  
  The phone number.
- phone_cc String
  
  The phone country code.
- fax_number String
  
  The fax number.
- fax_cc String
  
  The fax country code.
- address1 String
  
  The address1.
- address2 String
  
  The address2.
- city String
  
  The city.
- state String
  
  The state.
- zip String
  
  The zip.
- country String
  
  The country.

Api Request and Header

GET https://api.dynadot.com/restful/v1/contacts

Accept: application/json

Authorization: Bearer API_KEY

Response

{

code: "Integer",
message: "String",
data: {
- contact_list: [
  1. {
    - contact_id: "Integer",
    - organization: "String",
    - name: "String",
    - email: "String",
    - phone_number: "String",
    - phone_cc: "String",
    - fax_number: "String",
    - fax_cc: "String",
    - address1: "String",
    - address2: "String",
    - city: "String",
    - state: "String",
    - zip: "String",
    - country: "String"
    }
  ]
}

}

CONTACT_CREATE Command

Support multi-thread

Support API Sandbox

Require X-Signature

If calling the contact_create command, the following parameters should be included:

Request Parameters Expand All

contact Object
The Contact.
Show Properties
- organization String Optional
  
  The organization.
- name String
  
  The name of contact owner.
- email String
  
  The email address.
- phone_number String
  
  The phone number.
- phone_cc String
  
  The phone country code.
- fax_number String Optional
  
  The fax number.
- fax_cc String Optional
  
  The fax country code.
- address1 String
  
  The address1.
- address2 String Optional
  
  The address2.
- city String
  
  The city.
- state String Optional
  
  The state.
- zip String
  
  The zip.
- country String
  
  The country.

Result Parameters Expand All

contact_id Integer

The ID of contact.

Api Request and Header

POST https://api.dynadot.com/restful/v1/contacts

Content-Type: application/json

Accept: application/json

Authorization: Bearer API_KEY

X-Signature: {signature}

Request Body

{

contact: {
- organization: "String",
- name: "String",
- email: "String",
- phone_number: "String",
- phone_cc: "String",
- fax_number: "String",
- fax_cc: "String",
- address1: "String",
- address2: "String",
- city: "String",
- state: "String",
- zip: "String",
- country: "String"
13 items}

}

Response

{

code: "Integer",
message: "String",
data: {
- contact_id: "Integer"
}

}

CONTACT_UPDATE Command

Support multi-thread

Support API Sandbox

Require X-Signature

If calling the contact_update command, the following parameters should be included:

Request Parameters Expand All

contact Object
The contact.
Show Properties
- organization String Optional
  
  The organization.
- name String
  
  The name of contact owner.
- email String
  
  The email address.
- phone_number String
  
  The phone number.
- phone_cc String
  
  The phone country code.
- fax_number String Optional
  
  The fax number.
- fax_cc String Optional
  
  The fax country code.
- address1 String
  
  The address1.
- address2 String Optional
  
  The address2.
- city String
  
  The city.
- state String Optional
  
  The state.
- zip String
  
  The zip.
- country String
  
  The country.

Result Parameters Expand All

contact_id Integer

The contact id.

Api Request and Header

PUT https://api.dynadot.com/restful/v1/contacts/{contact_id}

Content-Type: application/json

Accept: application/json

Authorization: Bearer API_KEY

X-Signature: {signature}

Request Body

{

contact: {
- organization: "String",
- name: "String",
- email: "String",
- phone_number: "String",
- phone_cc: "String",
- fax_number: "String",
- fax_cc: "String",
- address1: "String",
- address2: "String",
- city: "String",
- state: "String",
- zip: "String",
- country: "String"
13 items}

}

Response

{

code: "Integer",
message: "String",
data: {
- contact_id: "Integer"
}

}

CONTACT_DELETE Command

Support multi-thread

Support API Sandbox

Require X-Signature

If calling the contact_delete command, the following parameters should be included:

Request Parameters Expand All

Result Parameters Expand All

contact_id Integer

The Id of contact.

Api Request and Header

DELETE https://api.dynadot.com/restful/v1/contacts/{contact_id}

Content-Type: application/json

Accept: application/json

Authorization: Bearer API_KEY

X-Signature: {signature}

Response

{

code: "Integer",
message: "String",
data: {
- contact_id: "Integer"
}

}

CREATE_CN_AUDIT Command

Support multi-thread

Support API Sandbox

Require X-Signature

If calling the create_cn_audit command, the following parameters should be included:

Request Parameters Expand All

contact_type String

When the contact type is ENTERPRISE, you need to enter enterprise_id_type,enterprise_license_id, enterprise_url.
Supported valuesindividual, enterprise
individual_id_type String
Individual ID type.
Supported values
- jgz : { Officer's identity card of the People's Republic of China }
- sfz : { ID card of the People's Republic of China }
- hz : { Passport }
- gajmtx : { Exit-Entry Permit for Travelling to and from Hong Kong and Macao }
- twjmtx : { Travel passes for Taiwan Residents to Enter or Leave the Mainland }
- wjlsfz : { Foreign Permanent Resident ID Card of the People's Republic of China }
- gajzz : { Residence permit for Hong Kong, Macao }
- twjzz : { Residence permit for Taiwan residents }
- qt : { Others }
individual_url String

Document of natural person license ID. The file url on the server. Only jpg, gif, png, jpeg are allowed.
individual_license_id String

The individual license ID.
enterprise_id_type String Optional
Enterprise type.
Supported values
- org : { Organization Code Certificate }
- yyzz : { Business License }
- tydm : { Certificate for Uniform Social Credit Code }
- bddm : { Military Code Designation }
- jddwfw : { Military Paid External Service License }
- sydwfr : { Public Institution Legal Person Certificate }
- wgczjg : { Resident Representative Offices of Foreign Enterprises Registration Form }
- shttfr : { Social Organization Legal Person Registration Certificate }
- zjcs : { Religion Activity Site Registration Certificate }
- mbfqy : { Private Non-Enterprise Entity Registration Certificate }
- jjhfr : { Fund Legal Person Registration Certificate }
- lszy : { Practicing License of Law Firm }
- wgzhwh : { Registration Certificate of Foreign Cultural Center in China }
- wlczjg : { Resident Representative Office of Tourism Departments of Foreign Government Approval Registration Certificate }
- sfjd : { Judicial Expertise License }
- jwjg : { Overseas Organization Certificate }
- shfwjg : { Social Service Agency Registration Certificate }
- mbxxbx : { Private School Permit }
- yljgzy : { Medical Institution Practicing License }
- gzjgzy : { Notary Organization Practicing License }
- bjwsxx : { Beijing School for Children of Foreign Embassy Staff in China Permit }
- qttydm : { Others-Certificate for Uniform Social Credit Code }
- qt : { Others }
enterprise_license_id String Optional

The License number of enterprise document.
enterprise_url String Optional

Document of enterprise license. The file url on the server. Only jpg, gif, png, jpeg are allowed.

Api Request and Header

POST https://api.dynadot.com/restful/v1/contacts/{contact_id}/create_cn_audit

Content-Type: application/json

Accept: application/json

Authorization: Bearer API_KEY

X-Signature: {signature}

Request Body

{

contact_type: "String",
individual_id_type: "String",
individual_url: "String",
individual_license_id: "String",
enterprise_id_type: "String",
enterprise_license_id: "String",
enterprise_url: "String"

}

Response

{

code: "Integer",
message: "String"

}

GET_CN_AUDIT_STATUS Command

Support multi-thread

Support API Sandbox

If calling the get_cn_audit_status command, the following parameters should be included:

Request Parameters Expand All

is_gtld Boolean

If you query the audit result of the cnnic-gtld, please set this parameter to true.

Result Parameters Expand All

audit_status String

The audit status of cnnic audit record. You may got 'processing' or 'waiting for cnnic' or 'failed'. If failed, we will send you an email.
fail_reason String

If the audit unpassable, the failed reason will be displayed.

Api Request and Header

GET https://api.dynadot.com/restful/v1/contacts/{contact_id}/get_cn_audit_status

Accept: application/json

Authorization: Bearer API_KEY

Response

{

code: "Integer",
message: "String",
data: {
- audit_status: "String"
}

}

SET_CONTACT_EU_SETTING Command

Support multi-thread

Support API Sandbox

Require X-Signature

If calling the set_contact_eu_setting command, the following parameters should be included:

Request Parameters Expand All

contact_extension Object
The contact extension for eu.
Show Properties
- country_of_citizenship String
  The country code of the citizenship. If a contact's address is set to any country outside of Europe, you must provide a valid country of citizenship order to use the contact for .EU domains.
  Supported values
  at : { Austria }
  be : { Belgium }
  bg : { Bulgaria }
  cz : { Czech Republic }
  cy : { Cyprus }
  de : { Germany }
  dk : { Denmark }
  es : { Spain }
  ee : { Estonia }
  fi : { Finland }
  fr : { France }
  gr : { Greece }
  hr : { Croatia }
  hu : { Hungary }
  ie : { Ireland }
  it : { Italy }
  lt : { Lithuania }
  lu : { Luxembourg }
  lv : { Latvia }
  mt : { Malta }
  nl : { Netherlands }
  pl : { Poland }
  pt : { Portugal }
  ro : { Romania }
  se : { Sweden }
  si : { Slovenia }
  sk : { Slovakia }
  is : { Iceland }
  li : { Liechtenstein }
  no : { Norway }
- tld String
  
  The TLD of this contact extension.

Result Parameters Expand All

contact_id Integer

The contact.

Api Request and Header

PUT https://api.dynadot.com/restful/v1/contacts/{contact_id}/set_eu_setting

Content-Type: application/json

Accept: application/json

Authorization: Bearer API_KEY

X-Signature: {signature}

Request Body

{

contact_extension: {
- country_of_citizenship: "String",
- tld: "String"
2 items}

}

Response

{

code: "Integer",
message: "String",
data: {
- contact_id: "Integer"
}

}

SET_CONTACT_LT_SETTING Command

Support multi-thread

Support API Sandbox

Require X-Signature

If calling the set_contact_lt_setting command, the following parameters should be included:

Request Parameters Expand All

contact_extension Object
The contact extension for lt.
Show Properties
- organization_code String
  
  The organization code of the contact.
- tld String
  
  The TLD of this contact extension.

Result Parameters Expand All

contact_id Integer

The account ID.

Api Request and Header

PUT https://api.dynadot.com/restful/v1/contacts/{contact_id}/set_lt_setting

Content-Type: application/json

Accept: application/json

Authorization: Bearer API_KEY

X-Signature: {signature}

Request Body

{

contact_extension: {
- organization_code: "String",
- tld: "String"
2 items}

}

Response

{

code: "Integer",
message: "String",
data: {
- contact_id: "Integer"
}

}

SET_CONTACT_LV_SETTING Command

Support multi-thread

Support API Sandbox

Require X-Signature

If calling the set_contact_lv_setting command, the following parameters should be included:

Request Parameters Expand All

contact_extension Object
The contact extension for lv.
Show Properties
- registration_number String
  
  - For individual, Please enter Latvian identification number. - For companies and other legal entities, please enter registration number issued by the Latvian Register of Enterprises.
- vat_number String
  
  VAT number for foreign legal entities registered within European Union countries (this includes also Latvian companies).
- tld String
  
  The TLD of this contact extension.

Result Parameters Expand All

contact_id Integer

The contact's ID you want to edit.

Api Request and Header

PUT https://api.dynadot.com/restful/v1/contacts/{contact_id}/set_lv_setting

Content-Type: application/json

Accept: application/json

Authorization: Bearer API_KEY

X-Signature: {signature}

Request Body

{

contact_extension: {
- registration_number: "String",
- vat_number: "String",
- tld: "String"
3 items}

}

Response

{

code: "Integer",
message: "String",
data: {
- contact_id: "Integer"
}

}

SET_CONTACT_IT_SETTING Command

Support multi-thread

Support API Sandbox

Require X-Signature

If calling the set_contact_it_setting command, the following parameters should be included:

Request Parameters Expand All

contact_extension Object
The contact extension for it.
Show Properties
- country_of_citizenship String
  
  The nationality code.
- codice_doc_number String
  
  The codice document number.
- tld String
  
  The TLD of this contact extension.

Result Parameters Expand All

contact_id Integer

The contact's ID you want to edit.

Api Request and Header

PUT https://api.dynadot.com/restful/v1/contacts/{contact_id}/set_it_setting

Content-Type: application/json

Accept: application/json

Authorization: Bearer API_KEY

X-Signature: {signature}

Request Body

{

contact_extension: {
- country_of_citizenship: "String",
- codice_doc_number: "String",
- tld: "String"
3 items}

}

Response

{

code: "Integer",
message: "String",
data: {
- contact_id: "Integer"
}

}

NAMESERVER_GET Command

Support multi-thread

Support API Sandbox

Require X-Signature

If calling the nameserver_get command, the following parameters should be included:

Request Parameters Expand All

Result Parameters Expand All

nameserver Object
The name server.
Show Properties
- server_name String
  
  The name of the nameserver.
- ip_list List
  
  The IP list of the nameserver.

Api Request and Header

GET https://api.dynadot.com/restful/v1/nameservers/{nameserver}

Accept: application/json

Authorization: Bearer API_KEY

X-Signature: {signature}

Response

{

code: "Integer",
message: "String",
data: {
- server_name: "String",
- ip_list: [
  1. "String"
  ]
}

}

NAMESERVER_LIST Command

Support multi-thread

Support API Sandbox

Require X-Signature

If calling the nameserver_list command, the following parameters should be included:

Request Parameters Expand All

Result Parameters Expand All

nameserver_list List
The list of nameservers.
Show Properties
- server_name String
  
  The name of the nameserver.
- ip_list List
  
  The IP list of the nameserver.

Api Request and Header

GET https://api.dynadot.com/restful/v1/nameservers

Accept: application/json

Authorization: Bearer API_KEY

X-Signature: {signature}

Response

{

code: "Integer",
message: "String",
data: {
- nameserver_list: [
  1. {
    - server_name: "String",
    - ip_list: [
      1. "String"
      ]
    }
  ]
}

}

NAMESERVER_REGISTER Command

Support multi-thread

Support API Sandbox

Require X-Signature

If calling the nameserver_register command, the following parameters should be included:

Request Parameters Expand All

name_server Object
The name server.
Show Properties
- server_name String
  
  The name server, example: ns1.domain.com.
- ip String
  
  The ip of server, example: 127.0.0.1.

Api Request and Header

POST https://api.dynadot.com/restful/v1/nameservers/register

Content-Type: application/json

Accept: application/json

Authorization: Bearer API_KEY

X-Signature: {signature}

Request Body

{

name_server: {
- server_name: "String",
- ip: "String"
2 items}

}

Response

{

code: "Integer",
message: "String"

}

NAMESERVER_ADD_EXTERNAL Command

Support multi-thread

Support API Sandbox

Require X-Signature

If calling the nameserver_add_external command, the following parameters should be included:

Request Parameters Expand All

Api Request and Header

POST https://api.dynadot.com/restful/v1/nameservers/{nameserver}/add_external

Content-Type: application/json

Accept: application/json

Authorization: Bearer API_KEY

X-Signature: {signature}

Request Body

{}

Response

{

code: "Integer",
message: "String"

}

NAMESERVER_SET_IP Command

Support multi-thread

Support API Sandbox

Require X-Signature

If calling the nameserver_set_ip command, the following parameters should be included:

Request Parameters Expand All

ip_list List

The list of IPs you want to set to the name server.

Result Parameters Expand All

host String

The name server host.
server_id Integer

server id.

Api Request and Header

PUT https://api.dynadot.com/restful/v1/nameservers/{nameserver}/set_ip

Content-Type: application/json

Accept: application/json

Authorization: Bearer API_KEY

X-Signature: {signature}

Request Body

{

ip_list: [
1. "String"
1 item]

}

Response

{

code: "Integer",
message: "String",
data: {
- host: "String",
- server_id: "Integer"
}

}

NAMESERVER_DELETE Command

Support multi-thread

Support API Sandbox

Require X-Signature

If calling the nameserver_delete command, the following parameters should be included:

Request Parameters Expand All

Api Request and Header

DELETE https://api.dynadot.com/restful/v1/nameservers/{nameserver}

Content-Type: application/json

Accept: application/json

Authorization: Bearer API_KEY

X-Signature: {signature}

Response

{

code: "Integer",
message: "String"

}

GET_INFO Command

Support multi-thread

Support API Sandbox

Require X-Signature

If calling the get_info command, the following parameters should be included:

Request Parameters Expand All

Result Parameters Expand All

account_info Object
The account information.
Show Properties
- username String
  
  The username of the account.
- forum_name String
  
  The forum name of the account.
- avatar_url String
  
  The avatar URL of the account.
- account_contact Object
  The contact information of the account.
  
  Show Properties
  
  organization String
  
  The organization.
  
  name String
  
  The name of contact owner.
  
  email String
  
  The email address.
  
  phone_number String
  
  The phone number.
  
  phone_cc String
  
  The phone country code.
  
  fax_number String
  
  The fax number.
  
  fax_cc String
  
  The fax country code.
  
  address1 String
  
  The address1.
  
  address2 String
  
  The address2.
  
  city String
  
  The city.
  
  state String
  
  The state.
  
  zip String
  
  The zip.
  
  country String
  
  The country.
- customer_since Long
  
  The customer since date of the account.
- account_lock String
  
  The account lock status of the account.
- custom_time_zone String
  
  The custom time zone of the account.
- default_registrant_contact_id Integer
  
  The default registrant contact ID of the account.
- default_admin_contact_id Integer
  
  The default admin contact ID of the account.
- default_technical_contact_id Integer
  
  The default technical contact ID of the account.
- default_billing_contact_id Integer
  
  The default billing contact ID of the account.
- glue_info Object
  The default DNS setting of the account.
  
  Show Properties
  
  glue_type String
  
  The type of the nameserver.
  Supported valuestype_null, type_park, type_dns, type_user, type_forward, type_stealth, type_webhost_basic, type_dynasite, type_webhost_advanced, type_free_webhost, type_sitebuilder, type_forsale, type_reseller_storefront, type_park_bot
  
  nameservers List
  
  The nameservers.
  
  Show Properties
  
  server_name String Optional
  
  The name of the nameserver.
  
  ip_list List Optional
  
  The IP list of the nameserver.
  
  with_ads String
  
  The status of the ads.
  
  forward_to String
  
  The forward to.
  
  forward_type String
  
  The forward type.
  
  website_title String
  
  The title of the website.
  
  email_forward_type String
  
  The email forwarding settings.
  Supported valuesmtype_none, mtype_forward, mtype_mx
  
  mail_exchanges List
  
  The mail exchanges.
  
  Show Properties
  
  host String Optional
  
  Mail host, only used when forward type is mx, only used when "forward_type" is "mx".
  
  distance String Optional
  
  Distance is the highest priority, only used when "forward_type" is "mx".
  
  email_alias_list List
  
  The email alias list.
  
  Show Properties
  
  username String Optional
  
  The user name of the email alias, only used when "forward_type" is "forward".
  
  to_email String Optional
  
  The email address of the email alias, only used when "forward_type" is "forward".
  
  dns_main_list List
  
  The dns main list.
  
  Show Properties
  
  record_type String Optional
  
  The type of the record.
  Supported valuesa, cname, forward, aaaa, txt, stealth, mx, email, caa, aname, srv, ns
  
  record_value1 String Optional
  
  The value of the record.
  
  record_value2 String Optional
  
  The second value of the record.
  
  dns_sub_list List
  
  The dns sub list.
  
  Show Properties
  
  sub_host String Optional
  
  The subhost of the DNS record.
  
  record_type String Optional
  
  The record type of the DNS record.
  Supported valuesa, cname, forward, aaaa, txt, stealth, mx, email, caa, aname, srv, ns
  
  record_value1 String Optional
  
  The value of the DNS record.
  
  record_value2 String Optional
  
  The second value of the DNS record.
  
  ttl String
  
  The time to live.
- total_spending String
  
  The total spending of the account.
- price_level String
  
  The price level of the account.
- account_balance String
  
  The current account balance of the account.
- balance_list List
  The default of the account balance in currency.
  
  Show Properties
  
  currency String
  
  The currency of the balance.
  
  amount String
  
  The amount of the balance.

Api Request and Header

GET https://api.dynadot.com/restful/v1/accounts/info

Accept: application/json

Authorization: Bearer API_KEY

X-Signature: {signature}

Response

{

code: "Integer",
message: "String",
data: {
- account_info: {
  - username: "String",
  - forum_name: "String",
  - avatar_url: "String",
  - account_contact: {
    - organization: "String",
    - name: "String",
    - email: "String",
    - phone_number: "String",
    - phone_cc: "String",
    - fax_number: "String",
    - fax_cc: "String",
    - address1: "String",
    - address2: "String",
    - city: "String",
    - state: "String",
    - zip: "String",
    - country: "String"
    },
  - customer_since: "Long",
  - account_lock: "String",
  - custom_time_zone: "String",
  - default_registrant_contact_id: "Integer",
  - default_admin_contact_id: "Integer",
  - default_technical_contact_id: "Integer",
  - default_billing_contact_id: "Integer",
  - default_name_server_settings: {
    - type: "String",
    - with_ads: "String",
    - forward_to: "String",
    - forward_type: "String",
    - website_title: "String",
    - ttl: "String",
    - email_forwarding: {
      - type: "String"
      }
    },
  - total_spending: "String",
  - price_level: "String",
  - account_balance: "String",
  - balance_list: [
    1. {
      - currency: "String",
      - amount: "String"
      }
    ]
  }
}

}

SET_DEFAULT_NAMESERVERS Command

Support multi-thread

Support API Sandbox

Require X-Signature

If calling the set_default_nameservers command, the following parameters should be included:

Request Parameters Expand All

nameserver_list List

The list of nameservers you want to set.

Result Parameters Expand All

name_servers List
The list of nameserver you want to set.
Show Properties
- server_name String
  
  The name of the nameserver.
- ip_list List
  
  The IP list of the nameserver.

Api Request and Header

PUT https://api.dynadot.com/restful/v1/accounts/default_nameservers

Content-Type: application/json

Accept: application/json

Authorization: Bearer API_KEY

X-Signature: {signature}

Request Body

{

nameserver_list: [
1. "String"
1 item]

}

Response

{

code: "Integer",
message: "String",
data: {
- name_servers: [
  1. {
    - server_name: "String"
    }
  ]
}

}

SET_DEFAULT_DOMAIN_FORWARDING Command

Support multi-thread

Support API Sandbox

Require X-Signature

If calling the set_default_domain_forwarding command, the following parameters should be included:

Request Parameters Expand All

forward_url String

The URL you want your domain to forward to. Please note that the parameter must be encoded so that the API call is interpreted properly.
is_temporary Boolean Optional

Whether the forwarding is temporary or permanent. If set to true, the forwarding will be removed after the first request is forwarded.

Api Request and Header

PUT https://api.dynadot.com/restful/v1/accounts/default_domain_forwarding

Content-Type: application/json

Accept: application/json

Authorization: Bearer API_KEY

X-Signature: {signature}

Request Body

{

forward_url: "String",
is_temporary: false

}

Response

{

code: "Integer",
message: "String"

}

SET_DEFAULT_STEALTH_FORWARDING Command

Support multi-thread

Support API Sandbox

Require X-Signature

If calling the set_default_stealth_forwarding command, the following parameters should be included:

Request Parameters Expand All

stealth_url String

The URL you want to set as the default stealth URL.
stealth_title String Optional

The title of the page that the domain will forward to.

Api Request and Header

PUT https://api.dynadot.com/restful/v1/accounts/default_stealth_forwarding

Content-Type: application/json

Accept: application/json

Authorization: Bearer API_KEY

X-Signature: {signature}

Request Body

{

stealth_url: "String",
stealth_title: "String"

}

Response

{

code: "Integer",
message: "String"

}

SET_DEFAULT_EMAIL_FORWARDING Command

Support multi-thread

Support API Sandbox

Require X-Signature

If calling the set_default_email_forwarding command, the following parameters should be included:

Request Parameters Expand All

email_forward_type String

The type of email forwarding you want to set.
Supported valuesmtype_none, mtype_forward, mtype_mx
email_alias_list List Optional
The email alias list you want to set.
Show Properties
- username String Optional
  
  The user name of the email alias, only used when "forward_type" is "forward".
- to_email String Optional
  
  The email address of the email alias, only used when "forward_type" is "forward".
mail_exchange_list List Optional
The mail exchange list you want to set.
Show Properties
- host String Optional
  
  Mail host, only used when forward type is mx, only used when "forward_type" is "mx".
- distance String Optional
  
  Distance is the highest priority, only used when "forward_type" is "mx".

Api Request and Header

PUT https://api.dynadot.com/restful/v1/accounts/default_email_forwarding

Content-Type: application/json

Accept: application/json

Authorization: Bearer API_KEY

X-Signature: {signature}

Request Body

{

email_forward_type: "String",
email_alias_list: [
1. {
  - username: "String",
  - to_email: "String"
  2 items}
1 item],
mail_exchange_list: [
1. {
  - host: "String",
  - distance: "String"
  2 items}
1 item]

}

Response

{

code: "Integer",
message: "String"

}

SET_DEFAULT_CONTACTS Command

Support multi-thread

Support API Sandbox

Require X-Signature

If calling the set_default_contacts command, the following parameters should be included:

Request Parameters Expand All

registrant_contact_id Integer

The ID of the contact you want to set as the default WHOIS registrant contact.
admin_contact_id Integer

The ID of the contact you want to set as the default WHOIS admin contact.
technical_contact_id Integer

The ID of the contact you want to set as the default WHOIS technical contact.
billing_contact_id Integer

The ID of the contact you want to set as the default WHOIS billing contact.

Api Request and Header

PUT https://api.dynadot.com/restful/v1/accounts/default_contacts

Content-Type: application/json

Accept: application/json

Authorization: Bearer API_KEY

X-Signature: {signature}

Request Body

{

registrant_contact_id: 0,
admin_contact_id: 0,
technical_contact_id: 0,
billing_contact_id: 0

}

Response

{

code: "Integer",
message: "String"

}

SET_DEFAULT_PARKING Command

Support multi-thread

Support API Sandbox

Require X-Signature

If calling the set_default_parking command, the following parameters should be included:

Request Parameters Expand All

with_ads Boolean Optional

If you do not want a 3rd-party ads on the parking page.

Api Request and Header

PUT https://api.dynadot.com/restful/v1/accounts/default_parking

Content-Type: application/json

Accept: application/json

Authorization: Bearer API_KEY

X-Signature: {signature}

Request Body

{

with_ads: false

}

Response

{

code: "Integer",
message: "String"

}

SET_DEFAULT_HOSTING Command

Support multi-thread

Support API Sandbox

Require X-Signature

If calling the set_default_hosting command, the following parameters should be included:

Request Parameters Expand All

hosting_type String

The default hosting type of the account you want to set.
Supported valuesbasic, advanced

Api Request and Header

PUT https://api.dynadot.com/restful/v1/accounts/default_hosts

Content-Type: application/json

Accept: application/json

Authorization: Bearer API_KEY

X-Signature: {signature}

Request Body

{

hosting_type: "String"

}

Response

{

code: "Integer",
message: "String"

}

SET_DEFAULT_RENEW_OPTION Command

Support multi-thread

Support API Sandbox

Require X-Signature

If calling the set_default_renew_option command, the following parameters should be included:

Request Parameters Expand All

renew_option String

The renew option you want to set.
Supported valuesreset, auto, donot

Api Request and Header

PUT https://api.dynadot.com/restful/v1/accounts/default_renew_option

Content-Type: application/json

Accept: application/json

Authorization: Bearer API_KEY

X-Signature: {signature}

Request Body

{

renew_option: "String"

}

Response

{

code: "Integer",
message: "String"

}

SET_DEFAULT_DNS Command

Support multi-thread

Support API Sandbox

Require X-Signature

If calling the set_default_dns command, the following parameters should be included:

Request Parameters Expand All

dns_main_list List
List of main DNS records, max 20.
Show Properties
- record_type String Optional
  
  The type of the record.
  Supported valuesa, cname, forward, aaaa, txt, stealth, mx, email, caa, aname, srv, ns
- record_value1 String Optional
  
  The value of the record.
- record_value2 String Optional
  
  The second value of the record.
sub_list List Optional
List of sub DNS records, max 100.
Show Properties
- sub_host String Optional
  
  The subhost of the DNS record.
- record_type String Optional
  
  The record type of the DNS record.
  Supported valuesa, cname, forward, aaaa, txt, stealth, mx, email, caa, aname, srv, ns
- record_value1 String Optional
  
  The value of the DNS record.
- record_value2 String Optional
  
  The second value of the DNS record.
ttl Long Optional

Time to live for DNS records, default is 86400.
add_dns_to_current_setting Boolean Optional

Add DNS records to current settings, default is false.

Api Request and Header

PUT https://api.dynadot.com/restful/v1/default_records

Content-Type: application/json

Accept: application/json

Authorization: Bearer API_KEY

X-Signature: {signature}

Request Body

{

dns_main_list: [
1. {
  - record_type: "String",
  - record_value1: "String",
  - record_value2: "String"
  3 items}
1 item],
sub_list: [
1. {
  - sub_host: "String",
  - record_type: "String",
  - record_value1: "String",
  - record_value2: "String"
  4 items}
1 item],
ttl: 0,
add_dns_to_current_setting: false

}

Response

{

code: "Integer",
message: "String"

}

CLEAR_DEFAULT_SETTING Command

Support multi-thread

Support API Sandbox

Require X-Signature

If calling the clear_default_setting command, the following parameters should be included:

Request Parameters Expand All

service_type String

The service type for the default account setting you wish to reset.
Supported valuesforward, stealth, email_forwarding, dns, nameservers

Api Request and Header

PUT https://api.dynadot.com/restful/v1/accounts/clear_default_setting

Content-Type: application/json

Accept: application/json

Authorization: Bearer API_KEY

X-Signature: {signature}

Request Body

{

service_type: "String"

}

Response

{

code: "Integer",
message: "String"

}

FOLDER_LIST Command

Support multi-thread

Support API Sandbox

If calling the folder_list command, the following parameters should be included:

Request Parameters Expand All

Result Parameters Expand All

folder_list List
The list of folders.
Show Properties
- folder_id String
  
  The ID of the folder.
- folder_name String
  
  The name of the folder.
- default_whois_enable_status String
  
  The default whois enable status.
- default_registrant_id String
  
  The default registrant ID.
- default_admin_id String
  
  The default admin ID.
- default_technical_id String
  
  The default technical ID.
- default_billing_id String
  
  The default billing ID.
- default_name_server_enable_status String
  
  The default name server enable status.
- default_name_server_setting Object
  The default name server setting.
  
  Show Properties
  
  glue_type String
  
  The type of the nameserver.
  Supported valuestype_null, type_park, type_dns, type_user, type_forward, type_stealth, type_webhost_basic, type_dynasite, type_webhost_advanced, type_free_webhost, type_sitebuilder, type_forsale, type_reseller_storefront, type_park_bot
  
  nameservers List
  
  The nameservers.
  
  Show Properties
  
  server_name String Optional
  
  The name of the nameserver.
  
  ip_list List Optional
  
  The IP list of the nameserver.
  
  with_ads String
  
  The status of the ads.
  
  forward_to String
  
  The forward to.
  
  forward_type String
  
  The forward type.
  
  website_title String
  
  The title of the website.
  
  email_forward_type String
  
  The email forwarding settings.
  Supported valuesmtype_none, mtype_forward, mtype_mx
  
  mail_exchanges List
  
  The mail exchanges.
  
  Show Properties
  
  host String Optional
  
  Mail host, only used when forward type is mx, only used when "forward_type" is "mx".
  
  distance String Optional
  
  Distance is the highest priority, only used when "forward_type" is "mx".
  
  email_alias_list List
  
  The email alias list.
  
  Show Properties
  
  username String Optional
  
  The user name of the email alias, only used when "forward_type" is "forward".
  
  to_email String Optional
  
  The email address of the email alias, only used when "forward_type" is "forward".
  
  dns_main_list List
  
  The dns main list.
  
  Show Properties
  
  record_type String Optional
  
  The type of the record.
  Supported valuesa, cname, forward, aaaa, txt, stealth, mx, email, caa, aname, srv, ns
  
  record_value1 String Optional
  
  The value of the record.
  
  record_value2 String Optional
  
  The second value of the record.
  
  dns_sub_list List
  
  The dns sub list.
  
  Show Properties
  
  sub_host String Optional
  
  The subhost of the DNS record.
  
  record_type String Optional
  
  The record type of the DNS record.
  Supported valuesa, cname, forward, aaaa, txt, stealth, mx, email, caa, aname, srv, ns
  
  record_value1 String Optional
  
  The value of the DNS record.
  
  record_value2 String Optional
  
  The second value of the DNS record.
  
  ttl String
  
  The time to live.
- default_renew_option_enable_status String
  
  The default renew option enable status.
- default_renew_option String
  
  The default renew option.
- default_transfer_lock_enable_status String
  
  The default transfer lock enable status.
- default_lock_status String
  
  The default lock status.

Api Request and Header

GET https://api.dynadot.com/restful/v1/folders

Accept: application/json

Authorization: Bearer API_KEY

Response

{

code: "Integer",
message: "String",
data: {
- folder_list: [
  1. {
    - folder_id: "Integer",
    - folder_name: "String",
    - default_whois: {
      - default_whois_enable_status: "String",
      - default_registrant: {
        contact_id: "Integer"
        },
      - default_admin: {
        contact_id: "Integer"
        },
      - default_technical: {
        contact_id: "Integer"
        },
      - default_billing: {
        contact_id: "Integer"
        }
      },
    - default_nameservers: {
      - default_name_server_enable_status: "String",
      - name_server_settings: {
        type: "String",
        with_ads: "String"
        }
      },
    - default_renew_option: {
      - default_renew_option_enable_status: "String",
      - renew_option: "String"
      },
    - default_transfer_lock: {
      - default_transfer_lock_enable_status: "String",
      - lock_status: "String"
      }
    }
  ]
}

}

FOLDER_CREATE Command

Support multi-thread

Support API Sandbox

Require X-Signature

If calling the folder_create command, the following parameters should be included:

Request Parameters Expand All

folder_name String

The name of the folder that you wish to create.

Result Parameters Expand All

folder_name String

The name of the folder you created.
folder_id Integer

The ID of the folder you created.

Api Request and Header

POST https://api.dynadot.com/restful/v1/folders

Content-Type: application/json

Accept: application/json

Authorization: Bearer API_KEY

X-Signature: {signature}

Request Body

{

folder_name: "String"

}

Response

{

code: "Integer",
message: "String",
data: {
- folder_id: "Integer",
- folder_name: "String"
}

}

FOLDER_DELETE Command

Support multi-thread

Support API Sandbox

Require X-Signature

If calling the folder_delete command, the following parameters should be included:

Request Parameters Expand All

Api Request and Header

DELETE https://api.dynadot.com/restful/v1/folders/{folder_name}

Content-Type: application/json

Accept: application/json

Authorization: Bearer API_KEY

X-Signature: {signature}

Response

{

code: "Integer",
message: "String"

}

FOLDER_SET_NAME Command

Support multi-thread

Support API Sandbox

Require X-Signature

If calling the folder_set_name command, the following parameters should be included:

Request Parameters Expand All

new_folder_name String

The new name for the folder you wish to configure.

Api Request and Header

PUT https://api.dynadot.com/restful/v1/folders/{folder_name}/name

Content-Type: application/json

Accept: application/json

Authorization: Bearer API_KEY

X-Signature: {signature}

Request Body

{

new_folder_name: "String"

}

Response

{

code: "Integer",
message: "String"

}

FOLDER_SET_DNS Command

Support multi-thread

Support API Sandbox

Require X-Signature

If calling the folder_set_dns command, the following parameters should be included:

Request Parameters Expand All

dns_main_list List
The DNS main-records that you wish to configure for the DNS records.
Show Properties
- record_type String Optional
  
  The type of the record.
  Supported valuesa, cname, forward, aaaa, txt, stealth, mx, email, caa, aname, srv, ns
- record_value1 String Optional
  
  The value of the record.
- record_value2 String Optional
  
  The second value of the record.
dns_sub_list List Optional
The DNS sub-records that you wish to configure for the DNS records.
Show Properties
- sub_host String Optional
  
  The subhost of the DNS record.
- record_type String Optional
  
  The record type of the DNS record.
  Supported valuesa, cname, forward, aaaa, txt, stealth, mx, email, caa, aname, srv, ns
- record_value1 String Optional
  
  The value of the DNS record.
- record_value2 String Optional
  
  The second value of the DNS record.
ttl String Optional

The TTL("Time To Live") of you wish to configure DNS records.
apply_for_future_domain Boolean Optional

Apply this setting to domains that will be moved to this folder in the future.
sync_setting_to_existing_domains_in_this_folder Boolean Optional

Synchronize the settings of all domains in this folder.

Api Request and Header

PUT https://api.dynadot.com/restful/v1/folders/{folder_name}/records

Content-Type: application/json

Accept: application/json

Authorization: Bearer API_KEY

X-Signature: {signature}

Request Body

{

dns_main_list: [
1. {
  - record_type: "String",
  - record_value1: "String",
  - record_value2: "String"
  3 items}
1 item],
dns_sub_list: [
1. {
  - sub_host: "String",
  - record_type: "String",
  - record_value1: "String",
  - record_value2: "String"
  4 items}
1 item],
ttl: "String",
apply_for_future_domain: false,
sync_setting_to_existing_domains_in_this_folder: false

}

Response

{

code: "Integer",
message: "String"

}

FOLDER_SET_NAMESERVER Command

Support multi-thread

Support API Sandbox

Require X-Signature

If calling the folder_set_nameserver command, the following parameters should be included:

Request Parameters Expand All

folder_nameserver_list List

The list of nameservers you wish to configure.
apply_for_future_domain Boolean Optional

Apply this setting to domains that will be moved to this folder in the future.
sync_setting_to_existing_domains_in_this_folder Boolean Optional

Synchronize the settings of all domains in this folder.

Result Parameters Expand All

servers List
servers.
Show Properties
- server_name String
  
  The name of the nameserver.
- ip_list List
  
  The IP list of the nameserver.

Api Request and Header

PUT https://api.dynadot.com/restful/v1/folders/{folder_name}/nameservers

Content-Type: application/json

Accept: application/json

Authorization: Bearer API_KEY

X-Signature: {signature}

Request Body

{

folder_nameserver_list: [
1. "String"
1 item],
apply_for_future_domain: false,
sync_setting_to_existing_domains_in_this_folder: false

}

Response

{

code: "Integer",
message: "String",
data: {
- servers: [
  1. {
    - server_name: "String"
    }
  ]
}

}

FOLDER_SET_CONTACTS Command

Support multi-thread

Support API Sandbox

Require X-Signature

If calling the folder_set_contacts command, the following parameters should be included:

Request Parameters Expand All

reg_contact_id Integer

The ID of the contact you wish to configure as the registrant contact.
admin_contact_id Integer

The ID of the contact you wish to configure as the administrative contact.
tech_contact_id Integer

The ID of the contact you wish to configure as the technical contact.
bill_contact_id Integer

The ID of the contact you wish to configure as the billing contact.
apply_for_future_domain Boolean Optional

Apply this setting to domains that will be moved to this folder in the future.
sync_setting_to_existing_domains_in_this_folder Boolean Optional

Synchronize the settings of all domains in this folder.

Api Request and Header

PUT https://api.dynadot.com/restful/v1/folders/{folder_name}/contacts

Content-Type: application/json

Accept: application/json

Authorization: Bearer API_KEY

X-Signature: {signature}

Request Body

{

reg_contact_id: 0,
admin_contact_id: 0,
tech_contact_id: 0,
bill_contact_id: 0,
apply_for_future_domain: false,
sync_setting_to_existing_domains_in_this_folder: false

}

Response

{

code: "Integer",
message: "String"

}

FOLDER_SET_PARKING Command

Support multi-thread

Support API Sandbox

Require X-Signature

If calling the folder_set_parking command, the following parameters should be included:

Request Parameters Expand All

with_ads Boolean Optional

Determines whether to display advertisements on the parking page. Set to 'true' to enable ads, or 'false' to keep the page ad-free. Default is 'false'.
apply_for_future_domain Boolean Optional

Apply this setting to domains that will be moved to this folder in the future.
sync_setting_to_existing_domains_in_this_folder Boolean Optional

Synchronize the settings of all domains in this folder.

Api Request and Header

PUT https://api.dynadot.com/restful/v1/folders/{folder_name}/parking

Content-Type: application/json

Accept: application/json

Authorization: Bearer API_KEY

X-Signature: {signature}

Request Body

{

with_ads: false,
apply_for_future_domain: false,
sync_setting_to_existing_domains_in_this_folder: false

}

Response

{

code: "Integer",
message: "String"

}

FOLDER_SET_DOMAIN_FORWARDING Command

Support multi-thread

Support API Sandbox

Require X-Signature

If calling the folder_set_domain_forwarding command, the following parameters should be included:

Request Parameters Expand All

forward_url String

The URL you want your domain to forward to. Please note that the parameter must be encoded so that the API call is interpreted properly.
is_temporary Boolean Optional

The forward status of your domain you want, default value is "true", if you wish to forward permanently, use this parameter with "false".
apply_for_future_domain Boolean Optional

Apply this setting to domains that will be moved to this folder in the future.
sync_setting_to_existing_domains_in_this_folder Boolean Optional

Synchronize the settings of all domains in this folder.

Api Request and Header

PUT https://api.dynadot.com/restful/v1/folders/{folder_name}/domain_forwarding

Content-Type: application/json

Accept: application/json

Authorization: Bearer API_KEY

X-Signature: {signature}

Request Body

{

forward_url: "String",
is_temporary: false,
apply_for_future_domain: false,
sync_setting_to_existing_domains_in_this_folder: false

}

Response

{

code: "Integer",
message: "String"

}

FOLDER_SET_STEALTH_FORWARDING Command

Support multi-thread

Support API Sandbox

Require X-Signature

If calling the folder_set_stealth_forwarding command, the following parameters should be included:

Request Parameters Expand All

stealth_url String

The URL you want your domain to forward to. Please note that the parameter must be encoded so that the API call is interpreted properly.
stealth_title String Optional

The title of the page that the domain will forward to.
apply_for_future_domain Boolean Optional

Apply this setting to domains that will be moved to this folder in the future.
sync_setting_to_existing_domains_in_this_folder Boolean Optional

Synchronize the settings of all domains in this folder.

Api Request and Header

PUT https://api.dynadot.com/restful/v1/folders/{folder_name}/stealth_forwarding

Content-Type: application/json

Accept: application/json

Authorization: Bearer API_KEY

X-Signature: {signature}

Request Body

{

stealth_url: "String",
stealth_title: "String",
apply_for_future_domain: false,
sync_setting_to_existing_domains_in_this_folder: false

}

Response

{

code: "Integer",
message: "String"

}

FOLDER_SET_EMAIL_FORWARDING Command

Support multi-thread

Support API Sandbox

Require X-Signature

If calling the folder_set_email_forwarding command, the following parameters should be included:

Request Parameters Expand All

email_forward_type String

The email forwarding type you wish to configure email forwarding, MTYPE_NONE: Do not forward email, MTYPE_FORWARD: Deliver email to another mail host, MTYPE_MX: Deliver email to another mail host (MX record).
Supported valuesmtype_none, mtype_forward, mtype_mx
email_alias_list List Optional
The email alias list you wish to configure email forwarding.
Show Properties
- username String Optional
  
  The user name of the email alias, only used when "forward_type" is "forward".
- to_email String Optional
  
  The email address of the email alias, only used when "forward_type" is "forward".
mail_exchange_list List Optional
The mail exchange list you wish to configure email forwarding.
Show Properties
- host String Optional
  
  Mail host, only used when forward type is mx, only used when "forward_type" is "mx".
- distance String Optional
  
  Distance is the highest priority, only used when "forward_type" is "mx".
apply_for_future_domain Boolean Optional

Apply this setting to domains that will be moved to this folder in the future.
sync_setting_to_existing_domains_in_this_folder Boolean Optional

Synchronize the settings of all domains in this folder.

Api Request and Header

PUT https://api.dynadot.com/restful/v1/folders/{folder_name}/email_forwarding

Content-Type: application/json

Accept: application/json

Authorization: Bearer API_KEY

X-Signature: {signature}

Request Body

{

email_forward_type: "String",
email_alias_list: [
1. {
  - username: "String",
  - to_email: "String"
  2 items}
1 item],
mail_exchange_list: [
1. {
  - host: "String",
  - distance: "String"
  2 items}
1 item],
apply_for_future_domain: false,
sync_setting_to_existing_domains_in_this_folder: false

}

Response

{

code: "Integer",
message: "String"

}

FOLDER_SET_HOSTING Command

Support multi-thread

Support API Sandbox

Require X-Signature

If calling the folder_set_hosting command, the following parameters should be included:

Request Parameters Expand All

hosting_type String

The hosting type of the folder that you wish to set hosting.
Supported valuesbasic, advanced
apply_for_future_domain Boolean Optional

Apply this setting to domains that will be moved to this folder in the future.
sync_setting_to_existing_domains_in_this_folder Boolean Optional

Synchronize the settings of all domains in this folder.

Api Request and Header

PUT https://api.dynadot.com/restful/v1/folders/{folder_name}/hosts

Content-Type: application/json

Accept: application/json

Authorization: Bearer API_KEY

X-Signature: {signature}

Request Body

{

hosting_type: "String",
apply_for_future_domain: false,
sync_setting_to_existing_domains_in_this_folder: false

}

Response

{

code: "Integer",
message: "String"

}

FOLDER_SET_RENEW_OPTION Command

Support multi-thread

Support API Sandbox

Require X-Signature

If calling the folder_set_renew_option command, the following parameters should be included:

Request Parameters Expand All

renew_option String

The renew option you wish to configure.
Supported valuesreset, auto, donot
apply_for_future_domain Boolean Optional

Apply this setting to domains that will be moved to this folder in the future.
sync_setting_to_existing_domains_in_this_folder Boolean Optional

Synchronize the settings of all domains in this folder.

Api Request and Header

PUT https://api.dynadot.com/restful/v1/folders/{folder_name}/renew_option

Content-Type: application/json

Accept: application/json

Authorization: Bearer API_KEY

X-Signature: {signature}

Request Body

{

renew_option: "String",
apply_for_future_domain: false,
sync_setting_to_existing_domains_in_this_folder: false

}

Response

{

code: "Integer",
message: "String"

}

FOLDER_CLEAR_SETTING Command

Support multi-thread

Support API Sandbox

Require X-Signature

If calling the folder_clear_setting command, the following parameters should be included:

Request Parameters Expand All

service_type String

The service type you wish to clear the setting.
Supported valuesforward, stealth, email_forwarding, dns, nameservers

Api Request and Header

PUT https://api.dynadot.com/restful/v1/folders/{folder_name}/clear_setting

Content-Type: application/json

Accept: application/json

Authorization: Bearer API_KEY

X-Signature: {signature}

Request Body

{

service_type: "String"

}

Response

{

code: "Integer",
message: "String"

}

ORDER_GET_STATUS Command

Support multi-thread

Support API Sandbox

Require X-Signature

If calling the order_get_status command, the following parameters should be included:

Request Parameters Expand All

Result Parameters Expand All

order_id Integer

The id of the order to be queried.
order_status String

the status of the order.
order_status_item_list List
order status list.
Show Properties
- type String
  
  Order type.
- name String
  
  Order name.
- duration Integer
  
  Order duration.
- cost String
  
  Order cost.
- status String
  
  Order status.

Api Request and Header

GET https://api.dynadot.com/restful/v1/orders/{order_id}

Accept: application/json

Authorization: Bearer API_KEY

X-Signature: {signature}

Response

{

code: "Integer",
message: "String",
data: {
- order_id: "Integer",
- order_status: "String",
- order_status_item_list: [
  1. {
    - item_type: "String",
    - item_domain: "String",
    - item_status: "String"
    }
  ]
}

}

ORDER_GET_HISTORY Command

Support multi-thread

Support API Sandbox

Require X-Signature

If calling the order_get_history command, the following parameters should be included:

Request Parameters Expand All

domain_name_list List Optional

When the type of search_type is domain, you need to enter the correct domain name.
order_id_list List Optional

When the type of search_type is order_id, you need to enter the correct orderId.
search_type String

You can choose a value from the following list to represent.
Supported valuesdate_range, domain, order_id
start_time Long Optional

When the search_type is date_range and domain, you need to enter the correct order start timestamp, enter a 13-digit numberand the start and end timestamp lengths need to be consistent.
end_time Long Optional

When the search_type is date_range and domain, you need to enter the correct order start timestamp, enter a 13-digit numberand the start and end timestamp lengths need to be consistent.
payment_method List Optional

When the type of search_type is date_range, You can choose one or more payment types from the following list: paypal , account_balance , credit_card. If not specified, all payment types will be selected by default.

Result Parameters Expand All

order_list List
The list of orders.
Show Properties
- order_id Integer
  
  The order ID.
- submitted_date Long
  
  The order date.
- currency String
  
  The currency.
- total_cost String
  
  The total amount.
- total_paid String
  
  The total paid.
- payment_method String
  
  The payment method.
- status String
  
  Contains the status of the order.
- order_item List
  The order item list.
  
  Show Properties
  
  type String
  
  Order type.
  
  name String
  
  Order name.
  
  duration Integer
  
  Order duration.
  
  cost String
  
  Order cost.
  
  status String
  
  Order status.

Api Request and Header

GET https://api.dynadot.com/restful/v1/orders

Accept: application/json

Authorization: Bearer API_KEY

X-Signature: {signature}

Response

<?xml version="1.0" encoding="UTF-8"?> <Response> <Status> <Code>200</Code> <Message>Success</Message> </Status> <Data> <OrderList> <Order> <OrderId>123456</OrderId> <SubmittedTime>1763179668245</SubmittedTime> <Currency>USD</Currency> <PaymentMethod>Account Balance</PaymentMethod> <TotalCost>$8.00</TotalCost> <TotalPaid>$8.00</TotalPaid> <Status>Problem</Status> <OrderItem> <OrderItem> <Type>Domain Registration</Type> <Name>test.com</Name> <Duration>1</Duration> <Cost>2.99</Cost> <Status>Completed</Status> </OrderItem> <OrderItem> <Type>Domain Renewal</Type> <Name>test1.ac</Name> <Duration>1</Duration> <Cost>3.99</Cost> <Status>Completed</Status> </OrderItem> <OrderItem> <Type>Domain Transfer</Type> <Name>test2.de</Name> <Duration>1</Duration> <Cost>4.99</Cost> <Status>Completed</Status> </OrderItem> </OrderItem> </Order> <Order> <OrderId>123457</OrderId> <SubmittedTime>1763179668245</SubmittedTime> <Currency>EUR</Currency> <PaymentMethod>Paypal</PaymentMethod> <TotalCost>$100.00</TotalCost> <TotalPaid>$100.00</TotalPaid> <Status>Submitted</Status> <OrderItem> <OrderItem> <Type>Domain Registration</Type> <Name>test3.gg</Name> <Duration>1</Duration> <Cost>5.99</Cost> <Status>Completed</Status> </OrderItem> <OrderItem> <Type>Domain Renewal</Type> <Name>test4.uk</Name> <Duration>1</Duration> <Cost>6.99</Cost> <Status>Completed</Status> </OrderItem> <OrderItem> <Type>Domain Transfer</Type> <Name>test5.net</Name> <Duration>1</Duration> <Cost>7.99</Cost> <Status>Completed</Status> </OrderItem> </OrderItem> </Order> </OrderList> </Data> </Response>

{

code: "Integer",
message: "String",
data: {
- order_list: [
  1. {
    - order_id: "Integer",
    - submitted_time: "Long",
    - currency: "String",
    - payment_method: "String",
    - total_cost: "String",
    - total_paid: "String",
    - status: "String",
    - order_item: [
      1. {
        type: "String",
        name: "String",
        duration: "Integer",
        cost: "String",
        status: "String"
        }
      ]
    }
  ]
}

}

CANCEL_TRANSFER Command

Support multi-thread

Support API Sandbox

Require X-Signature

If calling the cancel_transfer command, the following parameters should be included:

Request Parameters Expand All

domain_name String

your domain name.

Api Request and Header

POST https://api.dynadot.com/restful/v1/orders/{order_id}/cancel_transfer

Content-Type: application/json

Accept: application/json

Authorization: Bearer API_KEY

X-Signature: {signature}

Request Body

{

domain_name: "String"

}

Response

{

code: "Integer",
message: "String"

}

AUTHORIZE_TRANSFER_AWAY Command

Support multi-thread

Support API Sandbox

Require X-Signature

If calling the authorize_transfer_away command, the following parameters should be included:

Request Parameters Expand All

domain_name String

The domain name to authorize transfer away.
approve Boolean

Whether to approve the transfer away.

Api Request and Header

POST https://api.dynadot.com/restful/v1/orders/{order_id}/authorize_transfer_away

Content-Type: application/json

Accept: application/json

Authorization: Bearer API_KEY

X-Signature: {signature}

Request Body

{

domain_name: "String",
approve: false

}

Response

{

code: "Integer",
message: "String"

}

SET_TRANSFER_AUTH_CODE Command

Support multi-thread

Support API Sandbox

Require X-Signature

If calling the set_transfer_auth_code command, the following parameters should be included:

Request Parameters Expand All

domain_name String

your domain name.
auth_code String

your transfer auth code.

Api Request and Header

POST https://api.dynadot.com/restful/v1/orders/{order_id}/update_transfer_auth_code

Content-Type: application/json

Accept: application/json

Authorization: Bearer API_KEY

X-Signature: {signature}

Request Body

{

domain_name: "String",
auth_code: "String"

}

Response

{

code: "Integer",
message: "String"

}

ADD_NEW_LEAD Command

Support multi-thread

Require X-Signature

If calling the add_new_lead command, the following parameters should be included:

Request Parameters Expand All

lead_type String

The lead type you want to set the lead for. Acceptable values are "buy_now", "make_offer".
Supported valuesbuy_now, make_offer
domain_name String

The domain name you want to add lead for, only 1 domain can be entered per request.
price String

The price you want to set the lead for.
buyer_name String

The buyers' name.
buyer_email String

The buyers' email.

Api Request and Header

POST https://api.dynadot.com/restful/v1/aftermarkets/leads

Content-Type: application/json

Accept: application/json

Authorization: Bearer API_KEY

X-Signature: {signature}

Request Body

{

lead_type: "String",
domain_name: "String",
price: "String",
buyer_name: "String",
buyer_email: "String"

}

Response

{

code: "Integer",
message: "String"

}

SET_FOR_SALE Command

Support multi-thread

Require X-Signature

If calling the set_for_sale command, the following parameters should be included:

Request Parameters Expand All

for_sale_type String

The type of sale you want to set for the domain(s).
Supported valuesnot_for_sale, marketplace, auction, portfolio_auction
currency String Optional

The currency you want to set the domain(s) for sale in.
Supported valuesusd, gbp, eur, inr, pln, zar, ltl, cny, cad, jpy, nzd, rub, aud, mxn, brl, idr, ars, cop, dkk, rsd, hkd, chf, aed, myr, ngn, kes, czk, btc, nok
listing_type String Optional

The type of listing you want to set the domain(s) for sale as.
Supported valuesbuy_now, make_offer, buy_now_and_make_offer
price String Optional

The price you want to set the domain(s) for sale at.
minimum_offer_price String Optional

The minimum offer price you want to set the domain(s) for sale at.
installment String Optional

The installment plan you want to set the domain(s) for sale with.
maximum_installments Integer Optional

The maximum number of installments you want to set the domain(s) for sale with.
category String Optional

The category you want to set the domain(s) for sale in.
Supported valuesadvertising, automotive, business, carerrs_education, consumer_goods, entertainment, fashion, finance, gambling, health, internet, other, places, real_estate, science, society, sports, technology, uncategorized, adult, home, ai, aerospace, agency, agriculture_company, analytics, alcohol, babies_kids, biotech, clean_energy, cleaning, community, construction_organization, cryptocurrency_blockchain, dating_relationship, daycare, dental, drone, ecommerce, food_drink, furniture, games, insurance, interior_design, legal_law, motivational, manufacturing, marketing, medical, metaverse, movies_tv, music_audio, news_media, nft, outdoor, payment, pets, politics, property_management, recruitment_staffing, services, security, social, transportation, travel, video_books_magazines, vitual_reality, website_design
sub_category String Optional

The sub-category you want to set the domain(s) for sale in.
Supported valuesnone, marketing, retail, sales, cars_trucks, enthusiasts, motorsports, investment, law, money, professions, services, apparel, electronics, games, pop_culture, casino, sports, fitness, medicine, blogs, ecommerce, domains, web_design, web_hosting, africa, asia, europe, north_america, south_america, culture, news, politics, religion, leisure_activities, professional, computers
description String Optional

The description you want to set the domain(s) for sale with.
allow_seo_index Boolean Optional

Whether you want to allow search engine indexing for the domain(s).

Api Request and Header

PUT https://api.dynadot.com/restful/v1/aftermarkets/domains/{domain_name}/for_sales

Content-Type: application/json

Accept: application/json

Authorization: Bearer API_KEY

X-Signature: {signature}

Request Body

{

for_sale_type: "String",
currency: "String",
listing_type: "String",
price: "String",
minimum_offer_price: "String",
installment: "String",
maximum_installments: 0,
category: "String",
sub_category: "String",
description: "String",
allow_seo_index: false

}

Response

{

code: "Integer",
message: "String"

}

SET_OTHER_PLATFORM_CONFIRM_ACTION Command

Support multi-thread

Require X-Signature

If calling the set_other_platform_confirm_action command, the following parameters should be included:

Request Parameters Expand All

action String

The action to be performed.
Supported valuesconfirm, delete
platform_type String

The type of the platform type.
Supported valuesafternic, sedo

Api Request and Header

POST https://api.dynadot.com/restful/v1/aftermarket/domains/{domain_name}/opt_in_fast_transfer

Content-Type: application/json

Accept: application/json

Authorization: Bearer API_KEY

X-Signature: {signature}

Request Body

{

action: "String",
platform_type: "String"

}

Response

{

code: "Integer",
message: "String"

}

GET_LISTINGS Command

Support multi-thread

If calling the get_listings command, the following parameters should be included:

Request Parameters Expand All

currency String

The currency you would like to use for the search.
Supported valuesusd, gbp, eur, inr, pln, zar, ltl, cny, cad, jpy, nzd, rub, aud, mxn, brl, idr, ars, cop, dkk, rsd, hkd, chf, aed, myr, ngn, kes, czk, btc, nok
exclude_pending_sale Boolean Optional

Exclude pending sale.
show_other_registrar Boolean Optional

Show other registrar.
count_per_page Integer

count per page.
page_index Integer

page index.

Result Parameters Expand All

listing_item_list List
List of listings.
Show Properties
- listing_id Integer
  
  The unique identifier of the listing.
- domain String
  
  The domain name.
- price String
  
  The price of the domain.
- in_bound_links Integer
  
  The number of inbound links to the domain.
- age Integer
  
  The age of the domain.
- is_pending_sale_locked Boolean
  
  Whether the domain is locked for pending sale.

Api Request and Header

GET https://api.dynadot.com/restful/v1/aftermarket/listings

Accept: application/json

Authorization: Bearer API_KEY

Response

{

code: "Integer",
message: "String",
data: {
- listing_item_list: [
  1. {
    - listing_id: "Integer",
    - domain: "String",
    - price: "String",
    - in_bound_links: "Integer",
    - age: "Integer",
    - is_pending_sale_locked: "String"
    }
  ]
}

}

GET_LISTING_ITEM Command

Support multi-thread

If calling the get_listing_item command, the following parameters should be included:

Request Parameters Expand All

currency String

The currency you would like to use for the search.
Supported valuesusd, gbp, eur, inr, pln, zar, ltl, cny, cad, jpy, nzd, rub, aud, mxn, brl, idr, ars, cop, dkk, rsd, hkd, chf, aed, myr, ngn, kes, czk, btc, nok

Result Parameters Expand All

listing_item Object
The listing item.
Show Properties
- listing_id Integer
  
  The unique identifier of the listing.
- domain String
  
  The domain name.
- price String
  
  The price of the domain.
- in_bound_links Integer
  
  The number of inbound links to the domain.
- age Integer
  
  The age of the domain.
- is_pending_sale_locked Boolean
  
  Whether the domain is locked for pending sale.

Api Request and Header

GET https://api.dynadot.com/restful/v1/aftermarket/listings/{domain_name}

Accept: application/json

Authorization: Bearer API_KEY

Response

{

code: "Integer",
message: "String",
data: {
- listing_item: {
  - listing_id: "Integer",
  - domain: "String",
  - price: "String",
  - in_bound_links: "Integer",
  - age: "Integer",
  - is_pending_sale_locked: "String"
  }
}

}

BUY_IT_NOW Command

Support multi-thread

Require X-Signature

If calling the buy_it_now command, the following parameters should be included:

Request Parameters Expand All

currency String Optional

The currency you would like to use for the purchase.
Supported valuesusd, gbp, eur, inr, pln, zar, ltl, cny, cad, jpy, nzd, rub, aud, mxn, brl, idr, ars, cop, dkk, rsd, hkd, chf, aed, myr, ngn, kes, czk, btc, nok

Api Request and Header

POST https://api.dynadot.com/restful/v1/aftermarket/listings/{domain_name}/buy_it_now

Content-Type: application/json

Accept: application/json

Authorization: Bearer API_KEY

X-Signature: {signature}

Request Body

{

currency: "String"

}

Response

{

code: "Integer",
message: "String"

}

BUY_EXPIRED_CLOSEOUT_DOMAIN Command

Support multi-thread

Require X-Signature

If calling the buy_expired_closeout_domain command, the following parameters should be included:

Request Parameters Expand All

currency String Optional

The currency you would like to use for the purchase.
Supported valuesusd, gbp, eur, inr, pln, zar, ltl, cny, cad, jpy, nzd, rub, aud, mxn, brl, idr, ars, cop, dkk, rsd, hkd, chf, aed, myr, ngn, kes, czk, btc, nok

Api Request and Header

POST https://api.dynadot.com/restful/v1/aftermarket/expired_closeouts/{domain_name}/purchase

Content-Type: application/json

Accept: application/json

Authorization: Bearer API_KEY

X-Signature: {signature}

Request Body

{

currency: "String"

}

Response

{

code: "Integer",
message: "String"

}

BACKORDER_REQUEST_LIST Command

Support multi-thread

If calling the backorder_request_list command, the following parameters should be included:

Request Parameters Expand All

start_time Long

The start time of the backorder request, in milliseconds since epoch.
end_time Long

The end time of the backorder request, in milliseconds since epoch.

Result Parameters Expand All

backorder_request_list List
The list of backorder requests.
Show Properties
- domain_name String
  
  The domain name of the backorder request.
- cut_off_time Long
  
  The cut-off time of the backorder request, in milliseconds since epoch.
- backorder_request_status String
  
  The status of the backorder request.

Api Request and Header

GET https://api.dynadot.com/restful/v1/aftermarket/backorders/requests

Accept: application/json

Authorization: Bearer API_KEY

Response

{

code: "Integer",
message: "String",
data: {
- backorder_request_list: [
  1. {
    - domain_name: "String",
    - cut_off_time: "Long",
    - backorder_request_status: "String"
    }
  ]
}

}

ADD_BACKORDER_REQUEST Command

Support multi-thread

Require X-Signature

If calling the add_backorder_request command, the following parameters should be included:

Request Parameters Expand All

Api Request and Header

POST https://api.dynadot.com/restful/v1/aftermarket/backorders/requests/{domain_name}

Content-Type: application/json

Accept: application/json

Authorization: Bearer API_KEY

X-Signature: {signature}

Request Body

{}

Response

{

code: "Integer",
message: "String"

}

DELETE_BACKORDER_REQUEST Command

Support multi-thread

Require X-Signature

If calling the delete_backorder_request command, the following parameters should be included:

Request Parameters Expand All

Api Request and Header

DELETE https://api.dynadot.com/restful/v1/aftermarket/backorders/requests/{domain_name}

Content-Type: application/json

Accept: application/json

Authorization: Bearer API_KEY

X-Signature: {signature}

Response

{

code: "Integer",
message: "String"

}

PLACE_AUCTION_BID Command

Support multi-thread

If calling the place_auction_bid command, the following parameters should be included:

Request Parameters Expand All

currency String

The currency to use for the bid.
Supported valuesusd, gbp, eur, inr, pln, zar, ltl, cny, cad, jpy, nzd, rub, aud, mxn, brl, idr, ars, cop, dkk, rsd, hkd, chf, aed, myr, ngn, kes, czk, btc, nok
bid_amount Double

The amount to bid.
is_backorder_auction Boolean Optional

Whether to backorder the domain.

Result Parameters Expand All

auction_item_details Object
The auction item details.
Show Properties
- auction_id Integer
  
  The auction ID.
- domain_name String
  
  The domain name.
- utf_domain String
  
  The domain name in UTF-8.
- is_idn Boolean
  
  Whether the domain is an IDN.
- auction_type String
  
  The type of auction.
  Supported valuesexpired, user, portfolio, backorder, registrar, registry, registryexpired, premiumuser
- current_bid_price String
  
  The current bid price.
- accepted_bid_price String
  
  The accepted bid price.
- currency String
  
  The currency of the auction.
  Supported valuesusd, gbp, eur, inr, pln, zar, ltl, cny, cad, jpy, nzd, rub, aud, mxn, brl, idr, ars, cop, dkk, rsd, hkd, chf, aed, myr, ngn, kes, czk, btc, nok
- is_high_bidder Boolean
  
  Whether the user is the high bidder.
- bids Integer
  
  The number of bids.
- bidders Integer
  
  The number of bidders.
- auction_status_id Integer
  
  The auction status ID.
- time_left String
  
  The time left in the auction.
- start_time String
  
  The start time of the auction.
- start_time_stamp Long
  
  The start time of the auction in milliseconds since the epoch.
- end_time String
  
  The end time of the auction.
- end_time_stamp Long
  
  The end time of the auction in milliseconds since the epoch.
- revenue String
  
  The revenue.
- visitors Long
  
  The number of visitors.
- links String
  
  The links.
- age Integer
  
  The age of the domain.
- estibot_appraisal String
  
  The Estibot appraisal.
- auction_ended Boolean
  
  Whether the auction has ended.
- customer_bided Boolean
  
  Whether the customer bided.
- customer_bid String
  
  The customer bid.
- customer_proxy_bid String
  
  The customer proxy bid.
- is_premium Boolean
  
  Whether the domain is premium.
- renewal_price String
  
  The renewal price.
- revenue_currency String
  
  The revenue currency.
- start_price String
  
  The start price.
- bid_history_item_list List
  The bid history.
  
  Show Properties
  
  bidder_name String
  
  The bidder name.
  
  bid_price String
  
  The bid price.
  
  currency String
  
  The currency.
  
  timestamp Long
  
  The timestamp.
  
  bid_status String
  
  The bid status.
  
  is_proxy_auto_bid Boolean
  
  Whether the bid is a proxy auto bid.
- auction_status_name String
  
  The auction status name.

Api Request and Header

POST https://api.dynadot.com/restful/v1/aftermarket/auctions/bids/{domain_name}

Content-Type: application/json

Accept: application/json

Authorization: Bearer API_KEY

Request Body

{

currency: "String",
bid_amount: 0,
is_backorder_auction: false

}

Response

{

code: "Integer",
message: "String"

}

GET_AUCTION_BIDS Command

Support multi-thread

If calling the get_auction_bids command, the following parameters should be included:

Request Parameters Expand All

currency String

The currency you would like to use for the purchase.
Supported valuesusd, gbp, eur, inr, pln, zar, ltl, cny, cad, jpy, nzd, rub, aud, mxn, brl, idr, ars, cop, dkk, rsd, hkd, chf, aed, myr, ngn, kes, czk, btc, nok

Result Parameters Expand All

auction_bid_details List
The list of auction bids.
Show Properties
- bid_id Integer
  
  The bid ID.
- auction_id Integer
  
  The auction ID.
- account_id String
  
  The account ID.
- domain String
  
  The domain name.
- domain_utf String
  
  The domain name in UTF-8.
- is_idn_domain Boolean
  
  Whether the domain is an IDN domain.
- auction_type String
  
  The auction type.
  Supported valuesexpired, user, portfolio, backorder, registrar, registry, registryexpired, premiumuser
- current_bid String
  
  The current bid.
- proxy_bid String
  
  The proxy bid amount.
- bid_status String
  
  The bid status.
- is_high_bidder Boolean
  
  Whether the bidder is the high bidder.
- active_bidders Integer
  
  The number of active bidders.
- time_left String
  
  The time left.
- end_time String
  
  The end time.
- end_time_stamp Long
  
  The end time stamp.

Api Request and Header

GET https://api.dynadot.com/restful/v1/aftermarket/auctions/bids

Accept: application/json

Authorization: Bearer API_KEY

Response

{

code: "Integer",
message: "String",
data: {
- auction_bid_details: [
  1. {
    - bid_id: "Integer",
    - auction_id: "Integer",
    - account_id: "String",
    - domain: "String",
    - domain_utf: "String",
    - is_idn_domain: "String",
    - auction_type: "String",
    - current_bid: "String",
    - proxy_bid: "String",
    - bid_status: "String",
    - is_high_bidder: "String",
    - active_bidders: "Integer",
    - time_left: "String",
    - end_time: "String",
    - end_time_stamp: "Long"
    }
  ]
}

}

GET_CLOSED_AUCTIONS Command

Support multi-thread

If calling the get_closed_auctions command, the following parameters should be included:

Request Parameters Expand All

currency String

The currency you would like to use for the purchase.
Supported valuesusd, gbp, eur, inr, pln, zar, ltl, cny, cad, jpy, nzd, rub, aud, mxn, brl, idr, ars, cop, dkk, rsd, hkd, chf, aed, myr, ngn, kes, czk, btc, nok
start_time Long

The timestamp indicating the start of the auction's end time.
end_time Long

The timestamp indicating the end of the auction's end time.

Result Parameters Expand All

closed_auction_list List
List of closed auctions.
Show Properties
- auction_id Integer
  
  The unique identifier of the auction.
- domain String
  
  The domain name of the auction.
- auction_status String
  
  The status of the auction.
  Supported valuesin_progress, closed_by_user, closed_by_admin, closed_by_renewal, complete, closed_by_transfer_away, reversed, in_future, closed_by_registrar, closed_by_not_meet_reserve, closed_by_registry
- bid_price String
  
  The bid price of the auction.
- currency String
  
  The currency of the auction.
  Supported valuesusd, gbp, eur, inr, pln, zar, ltl, cny, cad, jpy, nzd, rub, aud, mxn, brl, idr, ars, cop, dkk, rsd, hkd, chf, aed, myr, ngn, kes, czk, btc, nok
- bids Integer
  
  The number of bids on the auction.
- end_time String
  
  The end time of the auction.
- end_timestamp Long
  
  The end timestamp of the auction.
- auction_won_status String
  
  The status of the auction won.
- your_high_bid Double
  
  Your high bid.
- your_proxy_bid Double
  
  Your proxy bid.

Api Request and Header

GET https://api.dynadot.com/restful/v1/aftermarket/auctions/closed

Accept: application/json

Authorization: Bearer API_KEY

Response

{

code: "Integer",
message: "String",
data: {
- ClosedAuctionList: [
  1. {
    - auction_id: "Integer",
    - domain: "String",
    - auction_status: "String",
    - bid_price: "String",
    - bids: "String",
    - end_time: "String",
    - end_timestamp: "Long",
    - auction_won_status: "String",
    - your_high_bid: "String",
    - your_proxy_bid: "String"
    }
  ]
}

}

GET_OPEN_AUCTIONS Command

Support multi-thread

If calling the get_open_auctions command, the following parameters should be included:

Request Parameters Expand All

currency String

Currency of the auction.
Supported valuesusd, gbp, eur, inr, pln, zar, ltl, cny, cad, jpy, nzd, rub, aud, mxn, brl, idr, ars, cop, dkk, rsd, hkd, chf, aed, myr, ngn, kes, czk, btc, nok
auction_types List Optional

Multiple values can be provided, separated by ','.
Supported valuesexpired, user, portfolio, backorder, registrar, registry, registryexpired, premiumuser

Result Parameters Expand All

auction_detail_info_list List
List of auction details.
Show Properties
- auction_id Integer
  
  Auction ID.
- domain_name_utf String
  
  Domain name in UTF-8.
- current_price String
  
  Current price.
- currency String
  
  Currency of the current price.
- bids Integer
  
  Number of bids.
- end_time_utc String
  
  End time in UTC.
- end_time_stamp Long
  
  End time in timestamp.
- revenue String
  
  Revenue.
- revenue_currency String
  
  Currency of the revenue.
- visitors Long
  
  Number of visitors.
- inbound_links Integer
  
  Number of inbound links.
- age Integer
  
  Age.
- auction_type String
  
  Auction type.
- bidders Integer
  
  Number of bidders.
- time_left String
  
  Time left.
- renewal_price String
  
  Renewal price.

Api Request and Header

GET https://api.dynadot.com/restful/v1/aftermarket/auctions/open

Accept: application/json

Authorization: Bearer API_KEY

Response

{

code: "Integer",
message: "String",
data: {
- auction_detail_info_list: [
  1. {
    - auction_id: "Integer",
    - domain_name_utf: "String",
    - current_price: "String",
    - currency: "String",
    - bids: "Integer",
    - end_time_utc: "String",
    - end_time_stamp: "Integer",
    - revenue: "String",
    - revenue_currency: "String",
    - visitors: "Integer",
    - inbound_links: "Integer",
    - age: "Integer"
    }
  ]
}

}

GET_AUCTION_DETAILS Command

Support multi-thread

If calling the get_auction_details command, the following parameters should be included:

Request Parameters Expand All

currency String

The currency you would like to use for the purchase.
Supported valuesusd, gbp, eur, inr, pln, zar, ltl, cny, cad, jpy, nzd, rub, aud, mxn, brl, idr, ars, cop, dkk, rsd, hkd, chf, aed, myr, ngn, kes, czk, btc, nok

Result Parameters Expand All

api_auction_item_details Object
auction item detail.
Show Properties
- auction_id Integer
  
  The auction ID.
- domain_name String
  
  The domain name.
- utf_domain String
  
  The domain name in UTF-8.
- is_idn Boolean
  
  Whether the domain is an IDN.
- auction_type String
  
  The type of auction.
  Supported valuesexpired, user, portfolio, backorder, registrar, registry, registryexpired, premiumuser
- current_bid_price String
  
  The current bid price.
- accepted_bid_price String
  
  The accepted bid price.
- currency String
  
  The currency of the auction.
  Supported valuesusd, gbp, eur, inr, pln, zar, ltl, cny, cad, jpy, nzd, rub, aud, mxn, brl, idr, ars, cop, dkk, rsd, hkd, chf, aed, myr, ngn, kes, czk, btc, nok
- is_high_bidder Boolean
  
  Whether the user is the high bidder.
- bids Integer
  
  The number of bids.
- bidders Integer
  
  The number of bidders.
- auction_status_id Integer
  
  The auction status ID.
- time_left String
  
  The time left in the auction.
- start_time String
  
  The start time of the auction.
- start_time_stamp Long
  
  The start time of the auction in milliseconds since the epoch.
- end_time String
  
  The end time of the auction.
- end_time_stamp Long
  
  The end time of the auction in milliseconds since the epoch.
- revenue String
  
  The revenue.
- visitors Long
  
  The number of visitors.
- links String
  
  The links.
- age Integer
  
  The age of the domain.
- estibot_appraisal String
  
  The Estibot appraisal.
- auction_ended Boolean
  
  Whether the auction has ended.
- customer_bided Boolean
  
  Whether the customer bided.
- customer_bid String
  
  The customer bid.
- customer_proxy_bid String
  
  The customer proxy bid.
- is_premium Boolean
  
  Whether the domain is premium.
- renewal_price String
  
  The renewal price.
- revenue_currency String
  
  The revenue currency.
- start_price String
  
  The start price.
- bid_history_item_list List
  The bid history.
  
  Show Properties
  
  bidder_name String
  
  The bidder name.
  
  bid_price String
  
  The bid price.
  
  currency String
  
  The currency.
  
  timestamp Long
  
  The timestamp.
  
  bid_status String
  
  The bid status.
  
  is_proxy_auto_bid Boolean
  
  Whether the bid is a proxy auto bid.
- auction_status_name String
  
  The auction status name.

Api Request and Header

GET https://api.dynadot.com/restful/v1/aftermarket/auctions/{domain_name}

Accept: application/json

Authorization: Bearer API_KEY

Response

<?xml version="1.0" encoding="UTF-8"?> <Response> <Status> <Code>200</Code> <Message>Success</Message> </Status> <Data> <AuctionItemDetails> <AuctionId>12345</AuctionId> <DomainName>example.com</DomainName> <UtfName>example.com</UtfName> <IsIdn>false</IsIdn> <AuctionType>Registrar</AuctionType> <CurrentBidPrice>150.00</CurrentBidPrice> <AcceptedBidPrice>150.00</AcceptedBidPrice> <Currency>USD</Currency> <IsHighBidder>true</IsHighBidder> <Bids>2</Bids> <Bidders>2</Bidders> <AuctionStatusId>1</AuctionStatusId> <TimeLeft>1 hour</TimeLeft> <StartTime>2023-10-01T12:00:00Z</StartTime> <EndTime>2023-10-02T12:00:00Z</EndTime> <Revenue>10.00</Revenue> <Visitors>100</Visitors> <Links>https://example.com/auction/12345</Links> <Age>5</Age> <EstibotAppraisal>High</EstibotAppraisal> <AuctionEnded>false</AuctionEnded> <CustomerBided>true</CustomerBided> <CustomerBid>150.00</CustomerBid> <CustomerProxyBid>160.00</CustomerProxyBid> <IsPremium>true</IsPremium> <RenewalPrice>20.00</RenewalPrice> <RevenueCurrency>USD</RevenueCurrency> <StartPrice>100.00</StartPrice> <BidHistoryItemList> <BidHistoryItem> <BidderName>Bidder1</BidderName> <BidPrice>100.00</BidPrice> <Currency>USD</Currency> <Timestamp>1763179668251</Timestamp> <BidStatus>Active</BidStatus> <IsProxyAutoBid>true</IsProxyAutoBid> </BidHistoryItem> <BidHistoryItem> <BidderName>Bidder2</BidderName> <BidPrice>150.00</BidPrice> <Currency>USD</Currency> <Timestamp>1763179667251</Timestamp> <BidStatus>Active</BidStatus> <IsProxyAutoBid>false</IsProxyAutoBid> </BidHistoryItem> </BidHistoryItemList> <AuctionStatusName>Active</AuctionStatusName> </AuctionItemDetails> </Data> </Response>

{

code: "Integer",
message: "String",
data: {
- auction_item_details: {
  - auction_id: "Integer",
  - domain_name: "String",
  - utf_name: "String",
  - is_idn: "String",
  - auction_type: "String",
  - current_bid_price: "String",
  - accepted_bid_price: "String",
  - currency: "String",
  - is_high_bidder: "String",
  - bids: "Integer",
  - bidders: "Integer",
  - auction_status_id: "Integer",
  - time_left: "String",
  - start_time: "String",
  - end_time: "String",
  - revenue: "String",
  - visitors: "Long",
  - links: "String",
  - age: "Integer",
  - estibot_appraisal: "String",
  - auction_ended: "String",
  - customer_bided: "String",
  - customer_bid: "String",
  - customer_proxy_bid: "String",
  - is_premium: "String",
  - renewal_price: "String",
  - revenue_currency: "String",
  - start_price: "String",
  - bid_history_item_list: [
    1. {
      - bidder_name: "String",
      - bid_price: "String",
      - currency: "String",
      - timestamp: "Long",
      - bid_status: "String",
      - is_proxy_auto_bid: "String"
      }
    ],
  - auction_status_name: "String"
  }
}

}

GET_WHOIS_STATS Command

Support multi-thread

If calling the get_whois_stats command, the following parameters should be included:

Request Parameters Expand All

domain_name String

The domain name to get whois stats for.
date_type String

The date type to get whois stats for.
Supported valueslast_7_days, last_30_days, current_year, last_year

Result Parameters Expand All

stats List
The whois stats for the domain.
Show Properties
- date String
  
  The date of the whois stats.
- count Long
  
  The count of the whois stats.

Api Request and Header

GET https://api.dynadot.com/restful/v1/aftermarket/whois_stats

Accept: application/json

Authorization: Bearer API_KEY

Response

{

code: "Integer",
message: "String",
data: {
- stats: [
  1. {
    - date: "String",
    - count: "Long"
    }
  ]
}

}

GET_EXPIRED_CLOSEOUT_DOMAINS Command

Support multi-thread

If calling the get_expired_closeout_domains command, the following parameters should be included:

Request Parameters Expand All

currency String Optional

The currency of return result, it should be "USD", "EUR", or "CNY", default currency is US Dollars.
Supported valuesusd, eur, cny
page_num Integer Optional

Please enter the page number you want to query, default page number is 1.
page_size Integer Optional

Please enter the page size you want to query, default page size is 10.

Result Parameters Expand All

closeout_item_list List
The list of closeout items.
Show Properties
- domain_name String
  
  Domain name.
- domain_name_utf String
  
  Domain name in UTF-8.
- current_price String
  
  Current price.
- is_idn Boolean
  
  Is IDN.
- end_time_stamp Long
  
  End time stamp.
- renewal_price String
  
  Renewal price.
- expired_revenue String
  
  Expired revenue.
- estibot_appraisal String
  
  Estibot appraisal.
- inbound_links Integer
  
  Inbound links.
- monthly_visitors Integer
  
  Monthly visitors.
- currency String
  
  Currency.
- is_active Boolean
  
  Is active.
- auction_id Integer
  
  Auction ID.
- closeout_id Integer
  
  Closeout ID.
- age Integer
  
  Age.
- current_price_usd Long
  
  Current price USD.
- price_usd Long
  
  Price USD.
- seller_price Long
  
  Seller price.
- registrar_account_id String
  
  Registrar account ID.
- order_status Integer
  
  Order status.

Api Request and Header

GET https://api.dynadot.com/restful/v1/aftermarket/get_expired_closeout_domains

Accept: application/json

Authorization: Bearer API_KEY

Response

{

code: "Integer",
message: "String",
data: {
- closeout_item_list: [
  1. {
    - domain_name: "String",
    - domain_name_utf: "String",
    - current_price: "String",
    - is_idn: "String",
    - end_time_stamp: "Long",
    - renewal_price: "String",
    - expired_revenue: "String",
    - estibot_appraisal: "String",
    - inbound_links: "Integer",
    - monthly_visitors: "Integer",
    - currency: "String",
    - is_active: "String",
    - auction_id: "Integer",
    - closeout_id: "Integer",
    - age: "Integer",
    - current_price_usd: "Long",
    - price_usd: "Long",
    - seller_price: "Long",
    - registrar_account_id: "Integer",
    - order_status: "Integer"
    }
  ]
}

}

TLD_GET_TLD_PRICE Command

Support multi-thread

Support API Sandbox

If calling the tld_get_tld_price command, the following parameters should be included:

Request Parameters Expand All

currency String

The currency you would like to use for the search.
Supported valuesusd, gbp, eur, inr, pln, zar, ltl, cny, cad, jpy, nzd, rub, aud, mxn, brl, idr, ars, cop, dkk, rsd, hkd, chf, aed, myr, ngn, kes, czk, btc, nok
page_index Integer Optional

The page index.
count_per_page Integer Optional

The count per page.
sort String Optional

The sort : name_asc, name_desc, etc.
Supported valuesrank_asc, rank_desc, name_asc, name_desc, sales_asc, sales_desc, launch_date_asc, launch_date_desc, count_asc, count_desc, registry_asc, registry_desc
show_multi_year Boolean Optional

Whether to show multi-year prices.

Result Parameters Expand All

page_index Integer

The page index.
count_per_page Integer

The count per page.
sort String

The sort : name_asc, name_desc, etc.
Supported valuesrank_asc, rank_desc, name_asc, name_desc, sales_asc, sales_desc, launch_date_asc, launch_date_desc, count_asc, count_desc, registry_asc, registry_desc
price_level String

The price level.
currency String

The currency you would like to use for the search.
show_multi_year_price Boolean

Whether to show multi-year prices.
tld_price_list List
The list of TLD prices.
Show Properties
- tld String
  
  The TLD.
- usage String
  
  The usage.
- price_unit String
  
  The price unit.
- all_years_register_price List
  
  The price for all years registration.
- all_years_renew_price List
  
  The price for all years renewal.
- transfer_price String
  
  The transfer price.
- restore_price String
  
  The restore price.
- grace_fee_price String
  
  The grace fee price.
- support_privacy String
  
  The support privacy.
- grace_period_unit String
  
  The grace period unit.
- renew_grace_period String
  
  The renew grace period.
- restore_period String
  
  The restore period.
- delete_grace_period String
  
  The delete grace period.
- is_idn String
  
  The IDN.
- restriction String
  
  The restriction.
- on_sale String
  
  The onSale.

Api Request and Header

GET https://api.dynadot.com/restful/v1/tld/get_tld_price

Accept: application/json

Authorization: Bearer API_KEY

Response

{

code: "Integer",
message: "String",
data: {
- page_index: "Integer",
- count_per_page: "Integer",
- sort: "String",
- price_level: "String",
- currency: "String",
- show_multi_year_price: "String",
- tldPriceList: [
  1. {
    - tld: "String",
    - usage: "String",
    - priceUnit: "String",
    - allYearsRegisterPrice: [],
    - allYearsRenewPrice: [],
    - transferPrice: "String",
    - restorePrice: "String",
    - graceFeePrice: "String",
    - supportPrivacy: "String",
    - gracePeriodUnit: "String",
    - renewGracePeriod: "String",
    - restorePeriod: "String",
    - deleteGracePeriod: "String",
    - isIdn: "String",
    - restriction: "String",
    - onSale: "String"
    }
  ]
}

}

GET_SITE_BUILDER Command

Support multi-thread

Require X-Signature

If calling the get_site_builder command, the following parameters should be included:

Request Parameters Expand All

Result Parameters Expand All

sitebuilder Object
The sitebuilder object.
Show Properties
- domain_name String
  
  The name server, example: ns1.domain.com.
- template String
  
  The template of the sitebuilder.
  Supported valuescompass, skyline, coastal, pieces, column, simples, serendipity, meridian, journey, architecture, studio, link, common, no
- plan String
  
  The plan of sitebuilder.
  Supported valuesfree, basic, pro, business, paid
- is_published Boolean
  
  If the sitebuilder has been published.
- last_update Long
  
  The last update time of the sitebuilder.
- expiration Long
  
  The expiration time of the sitebuilder.
- site_url String
  
  The url of the sitebuilder.

Api Request and Header

GET https://api.dynadot.com/restful/v1/sitebuilders/{domain_name}

Accept: application/json

Authorization: Bearer API_KEY

X-Signature: {signature}

Response

{

code: "Integer",
message: "String",
data: {
- sitebuilder: {
  - domain_name: "String",
  - template: "String",
  - plan: "String",
  - is_published: "String",
  - last_update: "Long",
  - expiration: "Long",
  - site_url: "String"
  }
}

}

LIST_SITE_BUILDER Command

Support multi-thread

Require X-Signature

If calling the list_site_builder command, the following parameters should be included:

Request Parameters Expand All

Result Parameters Expand All

sitebuilder_list List
The list of sitebuilder.
Show Properties
- domain_name String
  
  The name server, example: ns1.domain.com.
- template String
  
  The template of the sitebuilder.
  Supported valuescompass, skyline, coastal, pieces, column, simples, serendipity, meridian, journey, architecture, studio, link, common, no
- plan String
  
  The plan of sitebuilder.
  Supported valuesfree, basic, pro, business, paid
- is_published Boolean
  
  If the sitebuilder has been published.
- last_update Long
  
  The last update time of the sitebuilder.
- expiration Long
  
  The expiration time of the sitebuilder.
- site_url String
  
  The url of the sitebuilder.

Api Request and Header

GET https://api.dynadot.com/restful/v1/sitebuilders

Accept: application/json

Authorization: Bearer API_KEY

X-Signature: {signature}

Response

{

code: "Integer",
message: "String",
data: {
- sitebuilder_list: [
  1. {
    - domain_name: "String",
    - template: "String",
    - plan: "String",
    - is_published: "String",
    - last_update: "Long",
    - expiration: "Long",
    - site_url: "String"
    }
  ]
}

}

CREATE_SITE_BUILDER Command

Support multi-thread

Require X-Signature

If calling the create_site_builder command, the following parameters should be included:

Request Parameters Expand All

set_domain_dns Boolean Optional

Whether to set the domain's DNS to the site builder's DNS.

Result Parameters Expand All

sitebuilder Object
The sitebuilder object.
Show Properties
- domain_name String
  
  The name server, example: ns1.domain.com.
- template String
  
  The template of the sitebuilder.
  Supported valuescompass, skyline, coastal, pieces, column, simples, serendipity, meridian, journey, architecture, studio, link, common, no
- plan String
  
  The plan of sitebuilder.
  Supported valuesfree, basic, pro, business, paid
- is_published Boolean
  
  If the sitebuilder has been published.
- last_update Long
  
  The last update time of the sitebuilder.
- expiration Long
  
  The expiration time of the sitebuilder.
- site_url String
  
  The url of the sitebuilder.

Api Request and Header

POST https://api.dynadot.com/restful/v1/sitebuilders/{domain_name}

Content-Type: application/json

Accept: application/json

Authorization: Bearer API_KEY

X-Signature: {signature}

Request Body

{

set_domain_dns: false

}

Response

{

code: "Integer",
message: "String",
data: {
- sitebuilder: {
  - domain_name: "String",
  - template: "String",
  - plan: "String",
  - is_published: "String",
  - last_update: "Long",
  - expiration: "Long",
  - site_url: "String"
  }
}

}

UPGRADE_SITE_BUILDER Command

Support multi-thread

Require X-Signature

If calling the upgrade_site_builder command, the following parameters should be included:

Request Parameters Expand All

set_domain_dns Boolean Optional

Whether to set the domain's DNS to the site builder's DNS.

Result Parameters Expand All

sitebuilder Object
The sitebuilder object.
Show Properties
- domain_name String
  
  The name server, example: ns1.domain.com.
- template String
  
  The template of the sitebuilder.
  Supported valuescompass, skyline, coastal, pieces, column, simples, serendipity, meridian, journey, architecture, studio, link, common, no
- plan String
  
  The plan of sitebuilder.
  Supported valuesfree, basic, pro, business, paid
- is_published Boolean
  
  If the sitebuilder has been published.
- last_update Long
  
  The last update time of the sitebuilder.
- expiration Long
  
  The expiration time of the sitebuilder.
- site_url String
  
  The url of the sitebuilder.

Api Request and Header

POST https://api.dynadot.com/restful/v1/sitebuilders/{domain_name}/upgrade

Content-Type: application/json

Accept: application/json

Authorization: Bearer API_KEY

X-Signature: {signature}

Request Body

{

set_domain_dns: false

}

Response

{

code: "Integer",
message: "String",
data: {
- sitebuilder: {
  - domain_name: "String",
  - template: "String",
  - plan: "String",
  - is_published: "String",
  - last_update: "Long",
  - expiration: "Long",
  - site_url: "String"
  }
}

}

LIST_COUPONS Command

Support multi-thread

Support API Sandbox

If calling the list_coupons command, the following parameters should be included:

Request Parameters Expand All

coupon_type String

The list of coupon types to get.
Supported valuesdomain, renew, transfer, restore, privacy, email_webhost, vps_webhost, ssl, sitebuilder, sitebuilder_renew, email_webhost_domain_bundle, vps_webhost_domain_bundle, sitebuilder_domain_bundle, order_level_discount, domain_registration_match, domain_bundle, drop_catch, logo_builder, renew_restore

Result Parameters Expand All

coupons List
The list of coupons.
Show Properties
- code String
  
  Coupon code.
- description String
  
  Coupon description.
- coupon_category String
  
  Coupon category.
  Supported valuesdomain_coupons, hosting_ssl_coupons, bundle_coupons, other
- discount_type String
  
  Discount type.
  Supported valuessale, dollar_amount_off, percentage_off, use_renew_price
- discount_info Object
  Discount information.
  
  Show Properties
  
  USD String
  
  The discount amount in USD.
  
  GBP String
  
  The discount amount in GBP.
  
  EUR String
  
  The discount amount in EUR.
  
  JPY String
  
  The discount amount in JPY.
  
  CAD String
  
  The discount amount in CAD.
  
  CNY String
  
  The discount amount in CNY.
  
  AUD String
  
  The discount amount in AUD.
  
  MXN String
  
  The discount amount in MXN.
  
  BRL String
  
  The discount amount in BRL.
  
  IDR String
  
  The discount amount in IDR.
  
  percentage String
  
  The discount percentage.
- restriction Object
  Coupon restriction.
  
  Show Properties
  
  price_levels List
  
  the price levels that the coupon is applicable to.
  
  uses_per_account Integer
  
  the number of times a coupon can be used per account.
  
  uses_system_wide Integer
  
  the number of times a coupon can be used system wide.
  
  uses_per_order Integer
  
  the number of times a coupon can be used per order.
  
  uses_per_day Integer
  
  the number of times a coupon can be used per day.
  
  items_per_account Integer
  
  the number of items a coupon can be used on per account.
  
  items_per_order Integer
  
  the number of items a coupon can be used on per order.
  
  items_per_ip Integer
  
  the number of items a coupon can be used on per IP.
  
  domain_duration_min Integer
  
  the minimum domain duration for the coupon.
  
  domain_duration_max Integer
  
  the maximum domain duration for the coupon.
  
  idn_restriction String
  
  the IDN restriction for the coupon.
- tlds List
  
  TLDs.
- start_date Long
  
  Start date.
- end_date Long
  
  End date.
- currencies List
  
  Currencies.

Api Request and Header

GET https://api.dynadot.com/restful/v1/orders/coupons

Accept: application/json

Authorization: Bearer API_KEY

Response

<?xml version="1.0" encoding="UTF-8"?> <Response> <Status> <Code>200</Code> <Message>Success</Message> </Status> <Data> <Coupons> <Coupon> <Code>code</Code> <Description>description</Description> <CouponType>DOMAIN_COUPONS</CouponType> <DiscountType>PERCENTAGE_OFF</DiscountType> <DiscountInfo> <Percentage>10.0%</Percentage> </DiscountInfo> <Restriction> <PriceLevels> <PriceLevel>RETAIL</PriceLevel> <PriceLevel>BULK</PriceLevel> <PriceLevel>BULK1</PriceLevel> </PriceLevels> <UsesPerAccount>1</UsesPerAccount> <UsesSystemWide>1</UsesSystemWide> <UsesPerIp>1</UsesPerIp> <ItemsPerAccount>1</ItemsPerAccount> <ItemsSystemWide>1</ItemsSystemWide> <ItemsPerOrder>1</ItemsPerOrder> <ItemsPerDay>1</ItemsPerDay> <DomainDurationMin>1</DomainDurationMin> <DomainDurationMax>1</DomainDurationMax> <IdnRestriction>IDN</IdnRestriction> <Tlds> <Tld>com</Tld> <Tld>net</Tld> <Tld>org</Tld> </Tlds> <Currencies> <Currency>USD</Currency> <Currency>GBP</Currency> <Currency>EUR</Currency> <Currency>INR</Currency> <Currency>CAD</Currency> <Currency>CNY</Currency> <Currency>AUD</Currency> <Currency>MXN</Currency> <Currency>BRL</Currency> <Currency>IDR</Currency> </Currencies> </Restriction> <StartDate>0</StartDate> <EndDate>0</EndDate> </Coupon> <Coupon> <Code>code</Code> <Description>description</Description> <CouponType>BUNDLE_COUPONS</CouponType> <DiscountType>SALE</DiscountType> <DiscountInfo> <USD>$0.00</USD> <GBP>�0.00</GBP> <EUR>�0.00</EUR> <INR>�0.00</INR> <CAD>C$0.00</CAD> <CNY>�0.00</CNY> <AUD>A$0.00</AUD> <MXN>Mex$0.00</MXN> <BRL>R$0.00</BRL> <IDR>Rp0.00</IDR> </DiscountInfo> <Restriction> <PriceLevels> <PriceLevel>RETAIL</PriceLevel> <PriceLevel>BULK</PriceLevel> <PriceLevel>BULK1</PriceLevel> </PriceLevels> <UsesPerAccount>1</UsesPerAccount> <UsesSystemWide>1</UsesSystemWide> <UsesPerIp>1</UsesPerIp> <ItemsPerAccount>1</ItemsPerAccount> <ItemsSystemWide>1</ItemsSystemWide> <ItemsPerOrder>1</ItemsPerOrder> <ItemsPerDay>1</ItemsPerDay> <DomainDurationMin>1</DomainDurationMin> <DomainDurationMax>1</DomainDurationMax> <IdnRestriction>IDN</IdnRestriction> <Tlds> <Tld>com</Tld> <Tld>net</Tld> <Tld>org</Tld> </Tlds> <Currencies> <Currency>USD</Currency> <Currency>GBP</Currency> <Currency>EUR</Currency> <Currency>INR</Currency> <Currency>CAD</Currency> <Currency>CNY</Currency> <Currency>AUD</Currency> <Currency>MXN</Currency> <Currency>BRL</Currency> <Currency>IDR</Currency> </Currencies> </Restriction> <StartDate>0</StartDate> <EndDate>0</EndDate> </Coupon> </Coupons> </Data> </Response>

{

code: "Integer",
message: "String",
data: {
- coupons: [
  1. {
    - code: "String",
    - description: "String",
    - coupon_type: "String",
    - discount_type: "String",
    - discount_info: {
      - Percentage: "String"
      },
    - restriction: {
      - price_levels: [
        "String"
        ],
      - uses_per_account: "Integer",
      - uses_system_wide: "Integer",
      - uses_per_ip: "Integer",
      - items_per_account: "Integer",
      - items_system_wide: "Integer",
      - items_per_order: "Integer",
      - items_per_day: "Integer",
      - domain_duration_min: "Integer",
      - domain_duration_max: "Integer",
      - idn_restriction: "String",
      - tlds: [
        "String"
        ],
      - currencies: [
        "String"
        ]
      },
    - start_date: "Long",
    - end_date: "Long"
    }
  ]
}

}

Privacy Notice