--- updatedAt: 2026-05-27T18:14:50.000Z agentTools: siteIndex: https://techdocs.akamai.com/llms.txt projectIndex: https://techdocs.akamai.com/edge-dns/llms.txt --- # Search for change lists Retrieves the change lists that you've created for the specified zone names. If the input list is empty, the response doesn't return any change lists. Note that it's possible to own a change list on a zone that you're no longer allowed to access. # 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": "Change lists", "version": "v2" }, "openapi": "3.0.0", "paths": { "/changelists/search": { "post": { "description": "Retrieves the change lists that you've created for the specified zone names. If the input list is empty, the response doesn't return any change lists. Note that it's possible to own a change list on a zone that you're no longer allowed to access.", "externalDocs": { "description": "See documentation for this operation in Akamai's Edge DNS API", "url": "https://techdocs.akamai.com/edge-dns/reference/post-changelists-search" }, "operationId": "post-changelists-search", "parameters": [ { "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" } } ], "requestBody": { "content": { "application/json": { "example": { "zones": [ "example.com", "example.net" ] }, "schema": { "additionalProperties": false, "description": "Zone names.", "properties": { "comment": { "description": "Any comment.", "type": "string" }, "zones": { "description": "Zone names.", "items": { "type": "string" }, "type": "array" } }, "required": [ "zones" ], "type": "object", "x-akamai": { "file-path": "schemas/zone-name-list.yaml" } } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "example": { "changeLists": [ { "changeTag": "476754f4-d605-479f-853b-db854d7254fa", "lastModifiedDate": "2021-02-01T12:00:12.524Z", "stale": false, "zone": "example.com", "zoneVersionId": "1d9c887c-49bb-4382-87a6-d1bf690aa58f" }, { "changeTag": "17bfec8f-2b95-4aec-9959-518998b8b3c6", "lastModifiedDate": "2021-04-21T19:04:00Z", "stale": true, "zone": "example.net", "zoneVersionId": "82ffbdd6-d328-4b8a-aa7c-bc9319c51bf3" } ] }, "schema": { "additionalProperties": false, "properties": { "changeLists": { "description": "Metadata about a change list. Includes the zone version that the change list was derived from when it was created.", "items": { "additionalProperties": false, "description": "Metadata about a change list. Includes the zone version that the change list was derived from when it was created.", "properties": { "changeTag": { "description": "An ETag for this change list.", "type": "string" }, "lastModifiedDate": { "description": "An ISO 8601 date indicating the last time the change list was modified.", "type": "string" }, "stale": { "description": "If the parent version isn't current, this change list is stale.", "type": "boolean" }, "zone": { "description": "The name of the zone.", "type": "string" }, "zoneVersionId": { "description": "The zone version identifier for the parent version of this change list.", "type": "string" } }, "required": [ "zone", "changeTag", "zoneVersionId", "stale", "lastModifiedDate" ], "type": "object", "x-akamai": { "file-path": "schemas/changelist-get.yaml" } }, "type": "array" } }, "required": [ "changeLists" ], "type": "object", "x-akamai": { "file-path": "schemas/get-changelists-response.yaml" } } } }, "description": "Successful response." }, "401": { "content": { "application/problem+json": { "example": { "detail": "not logged in", "instance": "https://problems.luna.akamaiapis.net/authoritative-dns/notLoggedIn/f804a623-444c-4e4f-a719-2190313b99d7", "problemId": "f804a623-444c-4e4f-a719-2190313b99d7", "status": 401, "title": "Not Logged In", "type": "https://problems.luna.akamaiapis.net/authoritative-dns/notLoggedIn" }, "schema": { "additionalProperties": true, "description": "An RFC 7807 problem details object returned when an error occurs.", "properties": { "detail": { "description": "A human-readable explanation of the error.", "type": "string" }, "instance": { "description": "A URI that identifies this specific error occurrence.", "type": "string" }, "problemId": { "description": "A unique identifier for this error occurrence.", "type": "string" }, "status": { "description": "The HTTP status code for this error.", "type": "integer" }, "title": { "description": "A short, human-readable summary of the error.", "type": "string" }, "type": { "description": "A non-navigable URI that uniquely identifies the error type.", "type": "string" } }, "type": "object", "x-akamai": { "file-path": "schemas/problem.yaml" } } } }, "description": "Unauthorized. Your credentials are missing or invalid." }, "415": { "content": { "application/problem+json": { "example": { "detail": "Content type 'text/plain' not supported.", "instance": "https://problems.luna.akamaiapis.net/authoritative-dns/unsupportedMediaType/f804a623-444c-4e4f-a719-2190313b99d7", "problemId": "f804a623-444c-4e4f-a719-2190313b99d7", "status": 415, "title": "Unsupported Media Type", "type": "https://problems.luna.akamaiapis.net/authoritative-dns/unsupportedMediaType" }, "schema": { "additionalProperties": true, "description": "An RFC 7807 problem details object returned when an error occurs.", "properties": { "detail": { "description": "A human-readable explanation of the error.", "type": "string" }, "instance": { "description": "A URI that identifies this specific error occurrence.", "type": "string" }, "problemId": { "description": "A unique identifier for this error occurrence.", "type": "string" }, "status": { "description": "The HTTP status code for this error.", "type": "integer" }, "title": { "description": "A short, human-readable summary of the error.", "type": "string" }, "type": { "description": "A non-navigable URI that uniquely identifies the error type.", "type": "string" } }, "type": "object", "x-akamai": { "file-path": "schemas/problem.yaml" } } } }, "description": "Unsupported Media Type. The request's `Content-Type` header is not supported. Use `application/json`." } }, "summary": "Search for change lists", "tags": [ "Change lists" ] }, "x-akamai": { "file-path": "paths/search.yaml", "path-info": "/changelists/search" } } }, "servers": [ { "url": "https://{hostname}/config-dns/v2" } ], "tags": [ { "description": "Groups operations that you can use to manage change lists.", "name": "Change lists" } ], "x-akamai": { "auth-type": "EDGE_GRID", "file-path": "04-change-lists.yaml" }, "x-readme": { "explorer-enabled": false, "samples-languages": [ "curl", "python", "node" ] } } ``` # Sibling pages * [Create a change list](https://techdocs.akamai.com/edge-dns/reference/post-changelists.md) * [List user's change lists](https://techdocs.akamai.com/edge-dns/reference/get-changelists.md) * [Get a change list](https://techdocs.akamai.com/edge-dns/reference/get-changelists-zone.md) * [Delete a change list](https://techdocs.akamai.com/edge-dns/reference/delete-changelists-zone.md) * [Show changes](https://techdocs.akamai.com/edge-dns/reference/get-changelists-zone-diff.md) * [List record set names for a change list](https://techdocs.akamai.com/edge-dns/reference/get-changelists-zone-names.md) * [Submit a change list](https://techdocs.akamai.com/edge-dns/reference/post-changelists-zone-submit.md)