© 2002-2026 regfish GmbH. Regfish is a registered trademark of regfish GmbH. All prices include VAT. No guarantee for completeness. Our Terms and Conditions.
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"
}