DNS automation
v1.6.2
Get DNS zone details
Retrieve the complete DNS zone for the specified domain. The response includes SOA metadata, delegated nameservers, DNSSEC status, record counts, and all records stored in the zone, including
NS records.GET
/dns/zones/{domain}
DNSZonesByDomain
Authentication
Parameters
Name
Type
Format
Required
Description
domain
string
-
Required
Fully Qualified Domain Name.
Request example
GET
curl --request GET \
--url 'https://api.regfish.com/dns/zones/www.example.com' \
--header 'x-api-key: YOUR_API_KEY'Responses
200
Detailed DNS zone
Response example 200
{
"success": true,
"code": 0,
"response": {
"domain": "www.example.com",
"origin": "www.example.com.",
"active": true,
"signed": true,
"using_regfish_nameservers": true,
"delegation_nameservers": [
{
"host": "www.example.com."
}
],
"soa": {
"primary_nameserver": "www.example.com.",
"mailbox": "www.example.com.",
"serial": 1,
"refresh": 1,
"retry": 1,
"expire": 1,
"minimum": 1,
"ttl": 1
},
"record_count": 1,
"dnssec_state": "active",
"dnssec": {
"configured": true,
"dnssec_state": "active",
"mode": "none",
"desired_state": "disabled",
"live_state": "disabled",
"capabilities": {
"supported": true,
"provider": "example",
"mode_regfish_available": true,
"mode_external_available": true,
"accepted_record_kinds": [
null
],
"min_records": 1,
"accepted_algorithms": [
null
]
},
"desired_records": [
{}
],
"live_records": [
{}
],
"using_regfish_nameservers": true,
"legacy_mode": true,
"zone_signed": true,
"zone_pending_disable": true
},
"counts": {
"records_total": 1,
"records_active": 1,
"records_auto": 1,
"records_manual": 1,
"by_type": {}
},
"records": [
{
"id": 1,
"name": "example",
"type": "example",
"ttl": 1,
"auto": true,
"active": true,
"ts_created": 1,
"ts_updated": 1
}
]
}
}401
Unauthorized
Response example 401
{
"success": false,
"message": "Unauthorized",
"error": "Unauthorized"
}404
DNS zone not found
Response example 404
{
"success": false,
"message": "DNS zone not found",
"error": "DNS zone not found"
}500
Unexpected error
Response example 500
{
"success": false,
"message": "Unexpected error",
"error": "Unexpected error"
}Community
Forma parte de la comunidad
La DNS API de regfish es una gran solución para desarrolladores que quieren automatizar dominios y zonas DNS. Súmese a la comunidad y aproveche las ventajas de la automatización DNS. La DNS API está disponible gratis para todos los clientes de regfish.