API v1  |  API v2  |  API v3

The Dynadot API allows you to search for and register domain names programatically, using your own software and server. The API is available to all accounts.

Overview

Requests to the API are sent to the following url. Note that requests should be sent over https (secure socket) for security.

     https://api.dynadot.com/api.html

Only one request can be processed at a time. So please wait for your current request to finish before sending another request. The request should have the following parameters.

Request Parameter	Explanation
version	Version of the API; enter '1.0' which is the only version right now
key	Your key to access the API, available in your account control panel
command	The commands supported right now are 'search' and 'register'

The results are sent as a comma delimited text file. The first line is the result of the command. This line has 2 fields.

Result Field	Explanation
1	The result of this API call.   ok - the command was successful   error - the command was not successful
2	More information about the result. Only used when result is 'error'.

The second line is empty. Subsequent lines are the results of the command, for example your search results.

Search Command

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

Search Request Parameter	Explanation
domain0 - domain99	The domain name you are searching for; you can specify up to 100 domains
language0 - language99(optional)	The language tag for the respective domain; only use this for IDNs

There will be one result line for each domain submitted. Each line will have 5 fields.

Search Result Field	Explanation
1	The domain parameter. For example: domain0
2	The domain name searched for. For example: mydomain.com
3	The language if any. For example: spa
4	The result of the search:   yes - the domain is available   no - the domain is not available   offline - the central registry for this domain is currently offline   over_quota - see quota details below   error - there was a syntax or registry error processing this domain
5	More information about the result. Only used when result is 'error'.

Search Example

Request

https://api.dynadot.com/api.html?version=1.0&key=8S7I2s6Qd8g&
command=search&domain0=mydomain.com&domain1=mydomain.net

Response

ok,

domain0,mydomain.com,,no,
domain1,mydomain.net,,yes,

Register Command

Calling the register command will create and process a registration order. You must have enough account balance to pay for the order. If calling the register command, the following parameters should be included:

Register Request Parameter	Explanation
domain	The domain name you want to register; only one domain can be registered per request
language	The language tag for the requested domain; only needed if the domain is an IDN
duration	How long to register the domain for

There will be one result line for each request submitted. Each line will have 3 fields.

Register Result Field	Explanation
1	The result of the register request:   success - the domain was successfully registered   not_available - the domain is not available   insufficient_funds - not enough account balance to process this registration   offline - the central registry for this domain is currently offline   over_quota - see quota details below   error - there was a syntax or registry error processing this request
2	More information about the result. Only used when result is 'error'.
3	Expiration date in unix time (milliseconds since midnight UTC of January 1, 1970). Only used when result is 'success'.

Register Example

Request

https://api.dynadot.com/api.html?version=1.0&key=8S7I2s6Qd8g&
command=register&domain=mydomain.com&duration=1

Response

success,,1180897681932

Delete Command

Calling the delete command will delete a domain that is still in the grace period. Your account balance will be credited back the registration fee. Domains with privacy, that have been renewed, or that have been moved to a new account cannot be deleted through the API. If calling the delete command, the following parameters should be included:

Delete Request Parameter	Explanation
domain	The domain name you want to delete; only one domain can be deleted per request

There will be one result line for each request submitted. Each line will have 2 fields.

Delete Result Field	Explanation
1	The result of the delete request:   success - the domain was successfully deleted   grace_expired - the grace period has already expired   too_soon - cannot delete a domain the first hour after registration   offline - the central registry for this domain is currently offline   error - there was a syntax or registry error processing this request
2	More information about the result. Only used when result is 'error'.

Delete Example

Request

https://api.dynadot.com/api.html?version=1.0&key=8S7I2s6Qd8g&
command=delete&domain=mydomain.com

Response

success,

Languages

Afrikaans:afr Albanian:alb Arabic:ara Aragonese:arg Armenian:arm Assamese:asm Asturian:ast Avestan:ave Awadhi:awa Azerbaijani:aze Balinese:ban Baluchi:bal Basa:bas Bashkir:bak Basque:baq Belarusian:bel Bengali:ben Bhojpuri:bho Bosnian:bos Bulgarian:bul Burmese:bur Carib:car Catalan:cat Chechen:che Chinese:chi Chinese-Simplified:zh-cn Chinese-Traditional:zh-tw Chuvash:chv Coptic:cop Corsican:cos Croatian:scr Czech:cze Danish:dan Divehi:div Dogri:doi Dutch:dut Estonian:est Faroese:fao Fijian:fij Finnish:fin French:fre Frisian:fry Gaelic:gla Georgian:geo German:ger Gondi:gon Greek:gre Gujarati:guj Hebrew:heb Hindi:hin Hungarian:hun Icelandic:ice Indic:inc Indonesian:ind Ingush:inh Irish:gle Italian:ita Japanese:jpn Javanese:jav Kashmiri:kas Kazakh:kaz Khmer:khm Kirghiz:kir Korean:kor Kurdish:kur Lao:lao Latvian:lav Lithuanian:lit Luxembourgish:ltz Macedonian:mac Malayalam:mal Malay:may Maltese:mlt Maori:mao Moldavian:mol Mongolian:mon Nepali:nep Norwegian:nor Oriya:ori Ossetian:oss Panjabi:pan Persian:per Polish:pol Portuguese:por Pushto:pus Rajasthani:raj Romanian:rum Russian:rus Samoan:smo Sanskrit:san Sardinian:srd Serbian:scc Sindhi:snd Sinhalese:sin Slovak:slo Slovenian:slv Somali:som Spanish:spa Swahili:swa Swedish:swe Syriac:syr Tajik:tgk Tamil:tam Telugu:tel Thai:tha Tibetan:tib Turkish:tur Ukrainian:ukr Urdu:urd Uzbek:uzb Vietnamese:vie Welsh:wel Yiddish:yid