---
title: "Geo and CIDR Map overview"
slug: "geocidr-overview"
updated: 2026-09-17T10:12:30Z
published: 2026-09-17T10:12:30Z
canonical: "api.ncloud-docs.com/geocidr-overview"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://api.ncloud-docs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Geo and CIDR Map overview

## Overview

This feature allows you to call the features for creating, editing, and deleting Geo/CIDR maps provided by Global Traffic Manager using the specified API. You must use the authorized API key issued from the dashboard to make these calls.

## Common Global Traffic Manager settings

The following describes commonly used request and response formats in Global Traffic Manager APIs.

### Request

The following describes the common request format.

### API URL

The request API URL is as follows:

```
https://globaltrafficmanager.apigw.ntruss.com
```

### Request headers

The following describes the request headers.

| Field | Required | Description |
| --- | --- | --- |
| `x-ncp-apigw-timestamp` | Required | This is the number of milliseconds that have elapsed since January 1, 1970 00:00:00 UTC. - Request is considered invalid if the timestamp differs from the current time by more than 5 minutes. - Unix timestamp format. |
| `x-ncp-iam-access-key` | Required | Access key issued on NAVER Cloud Platform - Issue and check access key: See [Create authentication key](/docs/en/common-ncpapi#1%EC%9D%B8%EC%A6%9D%ED%82%A4%EC%83%9D%EC%84%B1). - Issue and check access key for sub account: See [Create sub account](https://guide.ncloud-docs.com/docs/en/subaccount-use#%EC%84%9C%EB%B8%8C-%EA%B3%84%EC%A0%95-%EC%83%9D%EC%84%B1). |
| `x-ncp-apigw-signature-v2` | Required | Base64-encoded signature that encrypts the request information with a secret key that maps to the access key issued on NAVER Cloud Platform, using the HMAC encryption algorithm (HmacSHA256). - Issue and check secret key: See [Create authentication key](/docs/en/common-ncpapi#1%EC%9D%B8%EC%A6%9D%ED%82%A4%EC%83%9D%EC%84%B1). - Create signature: See [Create signature](/docs/en/common-ncpapi#%EC%8B%9C%EA%B7%B8%EB%8B%88%EC%B2%98%EC%83%9D%EC%84%B1). |
| `Content-Type` | Optional | Request data format - `application/json` |

#### Response body

The response body includes the following data:

**error** error defines the API call failure information. The following describes error.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `result` | String | - | API call results - `FAIL`: Display when the call fails. |
| `error` | Object | - | Error code and message - Displayed if `success` is `false` |
| `error.errorCode` | Integer | - | Error code |
| `error.message` | String | - | Error message |
| `error.devMessage` | String | - | Error message for developers |
| `error.moreInfo` | Object | - | Additional error information |
| `error.moreInfo.validationInfo` | Array | - | Validity check error information |
| `error.moreInfo.validationInfo.fieldPath` | String | - | Field path where validity check error occurred |
| `error.moreInfo.validationInfo.msg` | String | - | Validity check error message |
| `error.moreInfo.timestamp` | String | - | Error occurrence time |

#### Response status codes

Global Traffic Manager APIs use NAVER Cloud Platform's common response status codes. For information about the HTTP status codes common to NAVER Cloud Platform, see [Ncloud API response status codes](/docs/en/common-ncpapi#3%EC%9D%91%EB%8B%B5%EC%83%81%ED%83%9C%EC%BD%94%EB%93%9C).

#### Response example

For response examples when a call is successful, see each API specification. The following is a sample response upon a failed call.

```
{
  "result": "FAIL",
  "error": {
    "errorCode": "05X000",
    "message": "Invalid value.<br>Hover your mouse over the displayed area to see the details in a tooltip.",
    "devMessage": "Invalid value.",
    "moreInfo": {
      "validationInfo": [
        {
          "fieldPath": "monitor.hostHeader",
          "msg": "hostHeader can't be entered unless the protocol is HTTP/HTTPS."
        }
      ],
      "timestamp": "2022-11-16T10:54:47.191+09:00"
    }
  }
}
```