---
updatedAt: 2026-05-26T22:11:56.000Z
agentTools:
  siteIndex: https://techdocs.akamai.com/llms.txt
  projectIndex: https://techdocs.akamai.com/gtm/llms.txt
---

# Get a geographic map

Returns information for a specific geographic map.

# OpenAPI definition

```json
{
  "externalDocs": {
    "description": "See documentation for Akamai's Global Traffic Management API",
    "url": "https://techdocs.akamai.com/gtm/reference"
  },
  "info": {
    "license": {
      "name": "Apache 2.0",
      "url": "https://www.apache.org/licenses/LICENSE-2.0.html"
    },
    "title": "Geographic maps",
    "version": "v1"
  },
  "openapi": "3.0.0",
  "paths": {
    "/domains/{domainName}/geographic-maps/{mapName}": {
      "get": {
        "description": "Returns information for a specific geographic map.",
        "externalDocs": {
          "description": "See documentation for this operation in Akamai's Global Traffic Management API",
          "url": "https://techdocs.akamai.com/gtm/reference/get-geographic-map"
        },
        "operationId": "get-geographic-map",
        "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"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "example": {
                  "assignments": [
                    {
                      "countries": [
                        "GB"
                      ],
                      "datacenterId": 3133,
                      "nickname": "UK users"
                    }
                  ],
                  "defaultDatacenter": {
                    "datacenterId": 5400,
                    "nickname": "Default Mapping"
                  },
                  "links": [
                    {
                      "href": "/config-gtm/v1/domains/example.akadns.net/geographic-maps/UK%20Delivery",
                      "rel": "self"
                    }
                  ],
                  "name": "UK Delivery"
                },
                "schema": {
                  "additionalProperties": false,
                  "description": "The geographic map configured for the property.",
                  "properties": {
                    "assignments": {
                      "description": "The geographic zone groupings of countries.",
                      "items": {
                        "additionalProperties": false,
                        "properties": {
                          "countries": {
                            "description": "Specifies an array of two-letter ISO 3166 `country` codes, or for finer subdivisions, the two-letter `country` code and the two-letter `stateOrProvince` code separated by a forward slash. For example, `US/TX`.",
                            "items": {
                              "maxLength": 10,
                              "minLength": 1,
                              "type": "string"
                            },
                            "type": "array"
                          },
                          "datacenterId": {
                            "description": "A unique identifier for an existing data center in the domain.",
                            "type": "integer"
                          },
                          "nickname": {
                            "description": "A descriptive label for the group.",
                            "maxLength": 128,
                            "minLength": 1,
                            "type": "string"
                          }
                        },
                        "type": "object"
                      },
                      "type": "array"
                    },
                    "defaultDatacenter": {
                      "additionalProperties": false,
                      "description": "A placeholder for all other geographic zones, countries not found in these geographic zones. Note that a geographic map cannot have the same countries in multiple geographic zones.",
                      "properties": {
                        "datacenterId": {
                          "description": "For each property, an identifier for all other geographic zones' CNAME. For example, 5400.",
                          "type": "integer"
                        },
                        "nickname": {
                          "description": "A descriptive label for all other geographic zones. The value ranges from 1 to 128 characters. If omitted, defaults to `Default Mapping`.",
                          "maxLength": 128,
                          "minLength": 1,
                          "type": "string"
                        }
                      },
                      "type": "object"
                    },
                    "links": {
                      "description": "Specifies the URL path that allows direct navigation to the geographic map.",
                      "items": {
                        "additionalProperties": false,
                        "description": "Lists navigable URLs to resources.",
                        "properties": {
                          "href": {
                            "description": "Provides a hypermedia link to the complete URL that uniquely defines a resource.",
                            "type": "string"
                          },
                          "rel": {
                            "description": "Indicates the link relationship of the object.",
                            "type": "string"
                          }
                        },
                        "type": "object",
                        "x-akamai": {
                          "file-path": "schemas/link.yaml"
                        }
                      },
                      "type": "array"
                    },
                    "name": {
                      "description": "A descriptive label for the geographic map, up to 128 characters.",
                      "maxLength": 128,
                      "minLength": 1,
                      "type": "string"
                    }
                  },
                  "type": "object",
                  "x-akamai": {
                    "file-path": "schemas/geographic-map.yaml"
                  }
                }
              }
            },
            "description": "Successful response."
          }
        },
        "summary": "Get a geographic map",
        "tags": [
          "Geographic maps"
        ]
      },
      "parameters": [
        {
          "description": "Unique name for the geographic map.",
          "in": "path",
          "name": "mapName",
          "required": true,
          "schema": {
            "example": "Software-rollout",
            "type": "string"
          },
          "x-akamai": {
            "file-path": "parameters/map-name-path.yaml"
          }
        },
        {
          "description": "The full GTM domain name.",
          "in": "path",
          "name": "domainName",
          "required": true,
          "schema": {
            "example": "example.akadns.net",
            "type": "string"
          },
          "x-akamai": {
            "file-path": "parameters/domain-name-path.yaml"
          }
        }
      ],
      "x-akamai": {
        "file-path": "paths/geographic-map.yaml",
        "path-info": "/domains/{domainName}/geographic-maps/{mapName}"
      }
    }
  },
  "servers": [
    {
      "url": "https://{hostname}/config-gtm/v1"
    }
  ],
  "x-akamai": {
    "auth-type": "EDGE_GRID",
    "file-path": "07-geographic-maps.yaml"
  },
  "x-readme": {
    "explorer-enabled": false,
    "samples-languages": [
      "curl",
      "python",
      "node"
    ]
  }
}
```

# Sibling pages

* [List geographic maps](https://techdocs.akamai.com/gtm/reference/get-geographic-maps.md)
* [Create or update a geographic map](https://techdocs.akamai.com/gtm/reference/put-geographic-map.md)
* [Remove a geographic map](https://techdocs.akamai.com/gtm/reference/delete-geographic-map.md)