Get a domain's DNS records
This request is used for getting all DNS records that were established for the domain.
Request syntax
The request should be sent over the HTTPS protocol using the GET method.
GET /api2/admin/dns/list?
domain=<domain name>
Host: pddimp.yandex.ru
PddToken: <PDD token>
Headers:
Parameters:
Parameter | Type | Value |
---|---|---|
domain | String | Name of the domain. |
Parameter | Type | Value |
---|---|---|
domain | String | Name of the domain. |
GET /api2/registrar/dns/list?
domain=<domain name>
Host: pddimp.yandex.ru
PddToken: <PDD token>
Authorization: OAuth <OAuth token>
Headers:
Name | Description |
---|---|
PddToken | |
Authorization |
Name | Description |
---|---|
PddToken | |
Authorization |
Parameters:
Parameter | Type | Value |
---|---|---|
domain | String | Name of the domain. |
Parameter | Type | Value |
---|---|---|
domain | String | Name of the domain. |
Request example
GET /api2/admin/dns/list?domain=domain.com HTTP/1.1
Host: pddimp.yandex.ru
PddToken: 123456789ABCDEF0000000000000000000000000000000000000
curl -H 'PddToken: 123456789ABCDEF0000000000000000000000000000000000000' 'https://pddimp.yandex.ru/api2/admin/dns/list?domain=domain.com'
GET /api2/admin/dns/list?domain=domain.com HTTP/1.1
Host: pddimp.yandex.ru
PddToken: 123456789ABCDEF0000000000000000000000000000000000000
Authorization: OAuth 00123456789ABCDEF00000000000000000000000000000000000
curl -H 'PddToken: 123456789ABCDEF0000000000000000000000000000000000000' -H 'Authorization: OAuth 00123456789ABCDEF00000000000000000000000000000000000' 'https://pddimp.yandex.ru/api2/admin/dns/list?domain=domain.com'
Response structure
{
"domain": "{domain name}",
"records":
[
{
"record_id": "{record ID}",
"type": "{record type}",
"domain": "{domain name}",
"fqdn": "{absolute domain name}",
"ttl": "{record lifetime}",
"subdomain": "{subdomain name}",
"content": "{record contents}",
"priority": "{record priority}"
},
...
],
"success": "{status of request execution}"
}
Name | Type of value | Description |
---|---|---|
domain | String | Name of the domain. |
records | Array | Properties of DNS records. Each object in the array corresponds to a single DNS record. |
success | String | Status of request execution. Possible values:
|
error | String | Error code. Included in the response if the request resulted in an error. Possible values:
|
Keys for objects in the records array | ||
record_id | Integer | ID of the DNS record. |
type | String | Type of DNS record. Possible values:
|
domain | String | Name of the domain. |
fqdn | String | Absolute domain name (). |
ttl | Integer | Lifetime of the DNS record, in seconds. |
subdomain | String | Subdomain name. For example, “my.domain.com” is the name of a subdomain of the “domain.com” domain. You can use “my” in place of “my.domain.com”. |
content | String | Contents of the DNS record. |
priority | Integer | Priority of the DNS record. Exists for MX and SRV records. For all other DNS records, an empty string is returned. |
Name | Type of value | Description |
---|---|---|
domain | String | Name of the domain. |
records | Array | Properties of DNS records. Each object in the array corresponds to a single DNS record. |
success | String | Status of request execution. Possible values:
|
error | String | Error code. Included in the response if the request resulted in an error. Possible values:
|
Keys for objects in the records array | ||
record_id | Integer | ID of the DNS record. |
type | String | Type of DNS record. Possible values:
|
domain | String | Name of the domain. |
fqdn | String | Absolute domain name (). |
ttl | Integer | Lifetime of the DNS record, in seconds. |
subdomain | String | Subdomain name. For example, “my.domain.com” is the name of a subdomain of the “domain.com” domain. You can use “my” in place of “my.domain.com”. |
content | String | Contents of the DNS record. |
priority | Integer | Priority of the DNS record. Exists for MX and SRV records. For all other DNS records, an empty string is returned. |