--- updatedAt: 2026-03-01T18:30:29.000Z agentTools: siteIndex: https://techdocs.akamai.com/llms.txt projectIndex: https://techdocs.akamai.com/edge-hostnames/llms.txt --- # List edge hostnames ```shell cURL chinaCdnEnabled=true comments="Created for site" customTarget="www.example-eip.com.eip.akadns.net" dnsZone="edgekey.net" isEdgeIPBindingEnabled="true" map="a;g.akamai.net" mapAlias="a;g4.akamai.net" recordNameSubstring="www.example.com" securityType="STANDARD-TLS" slotNumber=140 ttl=21600 egcurl --eg-section default --request GET \ --url "https://$hostname/hapi/v1/edge-hostnames?chinaCdnEnabled=$chinaCdnEnabled&comments=$comments&customTarget=$customTarget&dnsZone=$dnsZone&isEdgeIPBindingEnabled=$isEdgeIPBindingEnabled&map=$map&mapAlias=$mapAlias&recordNameSubstring=$recordNameSubstring&securityType=$securityType&slotNumber=$slotNumber&ttl=$ttl" \ --header "Accept: application/json" ``` ```node Node const EdgeGrid = require("akamai-edgegrid"); const os = require("os"); const edgercPath = os.homedir + "/.edgerc.txt"; const edgercSection = "default"; const eg = new EdgeGrid({ path: edgercPath, section: edgercSection }); eg.auth({ path: `/hapi/v1/edge-hostnames`, method: "GET", headers: { "Accept": "application/json"}, qs: { "chinaCdnEnabled": true, "comments": "Created for site", "customTarget": "www.example-eip.com.eip.akadns.net", "dnsZone": "edgekey.net", "isEdgeIPBindingEnabled": "true", "map": "a;g.akamai.net", "mapAlias": "a;g4.akamai.net", "recordNameSubstring": "www.example.com", "securityType": "STANDARD-TLS", "slotNumber": 140, "ttl": 21600} }); eg.send(function(error, response, body) { console.log(body); ``` ```python Python import requests from akamai.edgegrid import EdgeGridAuth, EdgeRc from urllib.parse import urljoin edgerc = EdgeRc('~/.edgerc.txt') section = 'default' baseurl = 'https://%s' % edgerc.get(section, 'host') session = requests.Session() session.auth = EdgeGridAuth.from_edgerc(edgerc, section) path= '/hapi/v1/edge-hostnames' headers = { "Accept": "application/json"} querystring = { "chinaCdnEnabled": true, "comments": "Created for site", "customTarget": "www.example-eip.com.eip.akadns.net", "dnsZone": "edgekey.net", "isEdgeIPBindingEnabled": "true", "map": "a;g.akamai.net", "mapAlias": "a;g4.akamai.net", "recordNameSubstring": "www.examples.com", "securityType": "STANDARD-TLS", "slotNumber": 140, "ttl": 21600 } result = session.get(urljoin(baseurl, path), headers=headers, params=querystring) print(result.status_code) print(result.json()) ``` ```json Response Example { "edgeHostnames": [ { "edgeHostnameId": 1, "recordName": "www.example.com", "dnsZone": "edgekey.net", "securityType": "ENHANCED-TLS", "useDefaultTtl": true, "useDefaultMap": true, "ipVersionBehavior": "IPV6_IPV4_DUALSTACK", "productId": "DSD", "ttl": 21600, "map": "e;dscb.akamaiedge.net", "slotNumber": 11838, "comments": "Created for example.com" }, { "edgeHostnameId": 2, "recordName": "www.examples.com", "dnsZone": "edgesuite.net", "securityType": "STANDARD-TLS", "useDefaultTtl": true, "useDefaultMap": true, "ipVersionBehavior": "IPV4", "productId": "DSA", "ttl": 21600, "map": "a;g.akamai.net", "serialNumber": 140, "comments": "Created for site" }, { "edgeHostnameId": 3, "recordName": "www.example-china.com", "dnsZone": "edgesuite.net", "useDefaultTtl": true, "useDefaultMap": true, "securityType": "STANDARD-TLS", "ipVersionBehavior": "IPV4", "productId": "DSA", "ttl": 1800, "map": "a;g.akamai.net", "serialNumber": 2322, "customTarget": "www.example-china.com.edgesuite.net.globalredir.akadns.net", "comments": "Created for China CDN", "chinaCdn": { "isChinaCdn": true } }, { "edgeHostnameId": 4, "recordName": "www.example-eip.com", "dnsZone": "edgekey.net", "useDefaultTtl": true, "useDefaultMap": true, "securityType": "ENHANCED-TLS", "ipVersionBehavior": "IPV4", "productId": "DSA", "ttl": 21600, "isEdgeIPBindingEnabled": true, "slotNumber": 2322, "customTarget": "www.example-eip.com.eip.akadns.net", "comments": "Created for EIP" } ] } ``` # Set up authorization Before you can use this API, you need to [Create authentication credentials](https://techdocs.akamai.com/developer/docs/set-up-authentication-credentials). Then, you can use these code samples to apply the token values to your requests. # Filter the results Optionally, filter results with these parameters: - `chinaCdnEnabled`. Finds the edge hostnames that can serve traffic in China when this parameter is set to `true`. - `comments`. Finds edge hostnames with a specific comment string. - `customTarget`. Finds edge hostnames with a user-specified target string. - `dnsZone`. Finds edge hostnames containing a Akamai-specific portion, such as `edgesuite.net`, `edgekey.net`, `akamaized.net` or `edgesuite-staging.net` - `isEdgeIPBindingEnabled`. Finds edge hostnames with edge IP binding enabled when this parameter is set to `true`. - `map` and `mapAlias`. Finds edge hostnames using specified map strings. - `recordNameSubstring`. Finds edge hostnames containing a specified origin domain. For example the `www.example.com` portion of `www.example.com.edgesuite.net`. - `securityType`. Finds edge hostnames using `STANDARD-TLS` or `ENHANCED-TLS` security type. - `slotNumber`. Finds edge hostnames with a specific value. `slotNumber` only applies when `securityType` is `ENHANCED-TLS`. - `ttl`. Finds edge hostnames where the time to live duration is set to a specific number of seconds. # Form the URL Use the URL to get all edge hostnames and parameter values or enter optional parameter values into the URL to filter the response. # Call the API Call GET on the request URL. # Review the response The response returns all edge hostnames and details available for the logged-in account and set filters. No filters were set in this example. Information such as `recordName` and `dnsZone` can be used to perform other GET or PATCH and DELETE operations.