--- updatedAt: 2026-08-28T06:26:38.000Z agentTools: siteIndex: https://techdocs.akamai.com/llms.txt projectIndex: https://techdocs.akamai.com/edge-dns/llms.txt --- # List a zone's delegation issues Returns delegation issues detected between the specified zone and its parent zone. The response is [paginated](ref:use-pagination). # OpenAPI definition ```json { "externalDocs": { "description": "See documentation for Akamai's Edge DNS API", "url": "https://techdocs.akamai.com/edge-dns/reference" }, "info": { "license": { "name": "Apache 2.0", "url": "https://www.apache.org/licenses/LICENSE-2.0.html" }, "title": "Zones", "version": "v2" }, "openapi": "3.0.0", "paths": { "/zones/{zone}/delegation-info": { "get": { "description": "Returns delegation issues detected between the specified zone and its parent zone. The response is [paginated](https://techdocs.akamai.com/edge-dns/reference/use-pagination).", "externalDocs": { "description": "See documentation for this operation in Akamai's Edge DNS API", "url": "https://techdocs.akamai.com/edge-dns/reference/get-zones-zone-delegation-info" }, "operationId": "get-zones-zone-delegation-info", "parameters": [ { "description": "Sorts results by the specified field. Prefix a field name with a dash to sort in descending order. You can specify multiple fields as a comma-separated list. Valid sort fields are `zone`, `parentZone`, `problemType`, `zoneSoa`, and `parentZoneSoa`. Defaults to ascending `zone` then `parentZone`.", "explode": false, "in": "query", "name": "sortBy", "schema": { "example": [ "zone", "-parentZone" ], "items": { "type": "string" }, "type": "array" }, "style": "form", "x-akamai": { "file-path": "parameters/sort-by-delegation-info-query.yaml" } }, { "description": "Which page of results to return. The first page is page `1`, the default value.", "in": "query", "name": "page", "schema": { "default": 1, "example": 1, "type": "integer" }, "x-akamai": { "file-path": "parameters/pageable-page.yaml" } }, { "description": "The number of results per page to return, `25` by default.", "in": "query", "name": "pageSize", "schema": { "default": 25, "example": 25, "type": "integer" }, "x-akamai": { "file-path": "parameters/pageable-page-size.yaml" } }, { "description": "Disables paging and sorting and shows the entire list all at once, `false` by default. Using this parameter may significantly increase the response time.", "in": "query", "name": "showAll", "schema": { "default": false, "example": true, "type": "boolean" }, "x-akamai": { "file-path": "parameters/pageable-show-all.yaml" } }, { "description": "For customers who manage more than one account, this [runs the operation from another account](https://techdocs.akamai.com/developer/docs/manage-many-accounts-with-one-api-client). The Identity and Access Management API provides a [list of available account switch keys](https://techdocs.akamai.com/iam-api/reference/get-client-account-switch-keys).", "in": "query", "name": "accountSwitchKey", "required": false, "schema": { "example": "1-5C0YLB:1-8BYUX", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "example": { "delegationInfo": [ { "parentZone": "example.com", "parentZoneSoa": 2024010101, "problemType": "PARENT_MISSING_DELEGATION_TO_CHILD", "zone": "sub.example.com", "zoneSoa": 2024010101 }, { "parentZone": "example.com", "parentZoneSoa": 2024010101, "problemType": "MODERN_DELEGATION_NOT_FOUND", "property": "ns1-sub.aka-ns.net", "zone": "sub.example.com", "zoneSoa": 2024010101 } ], "metadata": { "lastPage": 1, "page": 1, "pageSize": 25, "showAll": false, "totalElements": 2 } }, "schema": { "additionalProperties": false, "properties": { "delegationInfo": { "description": "Delegation issues detected for the zone.", "items": { "additionalProperties": false, "properties": { "parentZone": { "description": "The parent zone name.", "type": "string" }, "parentZoneSoa": { "description": "The SOA serial number for the parent zone.", "format": "int64", "type": "integer" }, "problemType": { "description": "The delegation issue type. Possible values are: `PARENT_MISSING_DELEGATION_TO_CHILD`, `PARENT_HAS_NON_AKAMAI_DELEGATION_TO_CHILD`, `LEGACY_DELEGATION_NOT_FOUND`, `MODERN_DELEGATION_NOT_FOUND`, or `MODERN_DELEGATION_WRONG_SIZE`.", "enum": [ "PARENT_MISSING_DELEGATION_TO_CHILD", "PARENT_HAS_NON_AKAMAI_DELEGATION_TO_CHILD", "LEGACY_DELEGATION_NOT_FOUND", "MODERN_DELEGATION_NOT_FOUND", "MODERN_DELEGATION_WRONG_SIZE" ], "type": "string" }, "property": { "description": "Provides additional context for the delegation issue. For `MODERN_DELEGATION_NOT_FOUND`, contains the expected name server FQDN. For `MODERN_DELEGATION_WRONG_SIZE`, contains the prefix path for the delegation.", "type": "string" }, "zone": { "description": "The zone name.", "type": "string" }, "zoneSoa": { "description": "The SOA serial number for the zone.", "format": "int64", "type": "integer" } }, "required": [ "parentZone", "parentZoneSoa", "problemType", "zone", "zoneSoa" ], "type": "object", "x-akamai": { "file-path": "schemas/cyclone-problem.yaml" } }, "type": "array" }, "metadata": { "additionalProperties": false, "description": "Information about the request.", "properties": { "lastPage": { "description": "The total number of pages available.", "minimum": 1, "type": "integer" }, "page": { "description": "The current page number.", "minimum": 1, "type": "integer" }, "pageSize": { "description": "The number of results per page.", "minimum": 1, "type": "integer" }, "showAll": { "description": "Whether all results are shown in a single response, without paging.", "type": "boolean" }, "totalElements": { "description": "The total number of delegation issues for the zone.", "minimum": 0, "type": "integer" } }, "required": [ "totalElements" ], "type": "object" } }, "required": [ "metadata", "delegationInfo" ], "type": "object", "x-akamai": { "file-path": "schemas/zone-delegation-info-report.yaml" } } } }, "description": "Delegation issues for the zone." } }, "summary": "List a zone's delegation issues", "tags": [ "Zone delegation" ] }, "parameters": [ { "description": "The name of the zone.", "in": "path", "name": "zone", "required": true, "schema": { "example": "example.com", "type": "string" }, "x-akamai": { "file-path": "parameters/zone-path.yaml" } } ], "x-akamai": { "file-path": "paths/zone-delegation-info.yaml", "path-info": "/zones/{zone}/delegation-info" } } }, "servers": [ { "url": "https://{hostname}/config-dns/v2" } ], "tags": [ { "description": "Groups operations to view delegation issues between a zone and its parent zone.", "name": "Zone delegation" } ], "x-akamai": { "auth-type": "EDGE_GRID", "file-path": "01-zones.yaml" }, "x-readme": { "explorer-enabled": false, "samples-languages": [ "curl", "python", "node" ] } } ``` # Sibling pages * [Summarize delegation warnings](https://techdocs.akamai.com/edge-dns/reference/post-zones-delegation-info-summary.md)