openapi.json

{
  "info": {
    "_postman_id": "607034d8-111f-44c3-9824-05476fc6acbb",
    "name": "IPGeolocation.io",
    "description": "## IPGeolocation.io API Collection\n\nComplete API collection for all IPGeolocation.io v3 endpoints.\n\n### Authentication\nAll requests require an API key passed as the `apiKey` query parameter.\n\n**Setup:** Open the collection → Variables tab → set your `apiKey` value.\n\nGet your API key at https://app.ipgeolocation.io/\n\n---\n\n### API Groups\n- **IP Geolocation API**: Single and bulk IP/domain lookups\n- **IP Security API**: VPN, proxy, Tor, bot, and threat intelligence\n- **ASN API**: Autonomous System Number metadata\n- **Abuse Contact API**: Registry-based abuse contact info\n- **Timezone API**: Timezone lookup and time conversion\n- **User-Agent API**: Parse browser, device, and OS details\n- **Astronomy API**: Sunrise, sunset, moon phase, and more\n\nFull documentation: https://ipgeolocation.io/documentation",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
  },
  "auth": {
    "type": "apikey",
    "apikey": [
      {
        "key": "key",
        "value": "apiKey",
        "type": "string"
      },
      {
        "key": "value",
        "value": "{{apiKey}}",
        "type": "string"
      },
      {
        "key": "in",
        "value": "query",
        "type": "string"
      }
    ]
  },
  "variable": [
    {
      "key": "apiKey",
      "value": "",
      "type": "string",
      "description": "Your IPGeolocation.io API key.\n\nGet yours at: https://app.ipgeolocation.io/\n\nPaste your key in the 'Current Value' field. It will be automatically appended as ?apiKey=... on every request in this collection."
    }
  ],
  "item": [
    {
      "name": "IP Geolocation API",
      "description": "IP geolocation API endpoints for looking up geographic location, network routing,\nASN ownership, company attribution, timezone, currency, security threat intelligence,\nabuse contact, and User-Agent data. Accepts IPv4 addresses, IPv6 addresses, and\ndomain names. The single lookup endpoint (`GET /v3/ipgeo`) resolves one IP or domain\nper request. The bulk lookup endpoint (`POST /v3/ipgeo-bulk`) accepts up to 50,000\nentries per request and requires a paid plan.",
      "item": [
        {
          "name": "Single IP Geolocation Lookup",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "https://api.ipgeolocation.io/v3/ipgeo",
              "protocol": "https",
              "host": [
                "api",
                "ipgeolocation",
                "io"
              ],
              "path": [
                "v3",
                "ipgeo"
              ],
              "query": [
                {
                  "key": "ip",
                  "value": "8.8.8.8",
                  "description": "An IPv4 address, IPv6 address, or domain name to look up. When omitted, the API resolves the public IP of the requesting client. Empty or whitespace-only values are treated the same as omission and resolve caller IP. Domain lookups require a paid plan. Pass `ip` only once. If multiple `ip` query parameters are sent, values may be merged and treated as invalid input (HTTP 400).",
                  "disabled": true
                },
                {
                  "key": "lang",
                  "value": "en",
                  "description": "Language code for translated location names. Defaults to `en`. Non-English responses require a paid plan. Free plans always receive English regardless of this parameter. Unsupported `lang` values return HTTP 400. Language code. Supported values: `en`, `de`, `ru`, `ja`, `fr`, `cn`, `es`, `cs`, `it`, `ko`, `fa`, `pt`. Defaults to `en`.",
                  "disabled": true
                },
                {
                  "key": "include",
                  "value": "security",
                  "description": "Comma-separated list of optional data modules to add to the response. These are not returned by default. Requires a paid plan.  If multiple hostname options are passed in `include`, hostname resolution uses this precedence order: `liveHostname` first, then `hostname`, then `hostnameFallbackLive`. If none is specified, the `hostname` field is not returned.  For `user_agent`, the API parses the `User-Agent` header from the request. For server-side calls, forward your visitor's User-Agent string in the header so the parsed result matches the actual visitor.  For additional query parameters (`include`, `fields`, `excludes`, `output`), unknown values are ignored. The API still returns HTTP 200 and applies only recognized values.  Free plan behavior for `include=*`: the API returns HTTP 200 and ignores the include request, returning only base response fields. In contrast, specific include values such as `include=security` return HTTP 401 on free plans.",
                  "disabled": true
                },
                {
                  "key": "fields",
                  "value": "location.city,security.threat_score,security.is_vpn",
                  "description": "Comma-separated list of fields or objects to return. Everything else is omitted. The `ip` field is always returned regardless of this filter.  Supports dot-notation for nested fields: `location.city`, `asn.organization`. To return an entire object, use the object key: `location`, `security`.  If a field belongs to an optional module (e.g. `security.threat_score`), you must also pass the corresponding `include` value. If you omit `include`, the request still succeeds, but fields from optional modules are not returned.  If the same field or object is specified in both `fields` and `excludes`, the object is still returned, but it will be empty. If the same field or object is specified in `include`, `fields`, and `excludes`, `include` takes priority over both `fields` and `excludes`.  If you list both an object key and one of its nested fields separated by comma (e.g. `security,security.threat_score`), the full object is returned.  Unknown field paths are ignored. The API still returns HTTP 200.  Available on all plans including Free.",
                  "disabled": true
                },
                {
                  "key": "excludes",
                  "value": "location.continent_code,currency,company.type",
                  "description": "Comma-separated list of fields or objects to remove from the response. The `ip` field cannot be excluded.  Supports dot-notation for nested fields: `location.continent_code`. To exclude an entire object, use the object key: `currency`, `time_zone`.  If the same field or object is specified in both `fields` and `excludes`, the object is still returned, but it will be empty. If the same field or object is specified in `include`, `fields`, and `excludes`, `include` takes priority over both `fields` and `excludes`.  Unknown fields or object keys in `excludes` are ignored. The API still returns HTTP 200.  Available on all plans including Free.",
                  "disabled": true
                },
                {
                  "key": "output",
                  "value": "json",
                  "description": "Desired response format. Defaults to `json` if not specified. You can also control the format using the `Accept` header (`application/json`, `application/xml`, or `text/xml`). If both are provided, the `output` parameter takes precedence.  If `output` is unknown or unsupported, it is ignored and the response defaults to JSON (`application/json`) with HTTP 200. Supported values: `json`, `xml`. Defaults to `json`.",
                  "disabled": true
                }
              ]
            },
            "description": "Returns geolocation and enrichment data for a single IPv4 address, IPv6 address,\nor domain name. When `ip` is omitted, the API resolves the caller's public IP\nautomatically, which is useful for client-side lookups.\n\nThe base response always includes `location`, `country_metadata`, `currency`,\n`asn`, and `time_zone`. Paid plans also get `network` and `company` by default.\n\nUse the `include` parameter to add optional modules such as `security`, `abuse`,\n`user_agent`, `geo_accuracy`, `dma_code`, and hostname resolution.\n\nUse `fields` and `excludes` to control exactly which parts of the response you\nreceive. This reduces payload size and can improve response times."
          },
          "response": [
            {
              "name": "200 OK – Paid plan, all modules included",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "https://api.ipgeolocation.io/v3/ipgeo",
                  "protocol": "https",
                  "host": [
                    "api",
                    "ipgeolocation",
                    "io"
                  ],
                  "path": [
                    "v3",
                    "ipgeo"
                  ],
                  "query": [
                    {
                      "key": "ip",
                      "value": "91.128.103.196",
                      "description": "An IPv4 address, IPv6 address, or domain name to look up. When omitted, the API resolves the public IP of the requesting client. Empty or whitespace-only values are treated the same as omission and resolve caller IP. Domain lookups require a paid plan. Pass `ip` only once. If multiple `ip` query parameters are sent, values may be merged and treated as invalid input (HTTP 400).",
                      "disabled": false
                    },
                    {
                      "key": "lang",
                      "value": "en",
                      "description": "Language code for translated location names. Defaults to `en`. Non-English responses require a paid plan. Free plans always receive English regardless of this parameter. Unsupported `lang` values return HTTP 400. Language code. Supported values: `en`, `de`, `ru`, `ja`, `fr`, `cn`, `es`, `cs`, `it`, `ko`, `fa`, `pt`. Defaults to `en`.",
                      "disabled": true
                    },
                    {
                      "key": "include",
                      "value": "*",
                      "description": "Comma-separated list of optional data modules to add to the response. These are not returned by default. Requires a paid plan.  If multiple hostname options are passed in `include`, hostname resolution uses this precedence order: `liveHostname` first, then `hostname`, then `hostnameFallbackLive`. If none is specified, the `hostname` field is not returned.  For `user_agent`, the API parses the `User-Agent` header from the request. For server-side calls, forward your visitor's User-Agent string in the header so the parsed result matches the actual visitor.  For additional query parameters (`include`, `fields`, `excludes`, `output`), unknown values are ignored. The API still returns HTTP 200 and applies only recognized values.  Free plan behavior for `include=*`: the API returns HTTP 200 and ignores the include request, returning only base response fields. In contrast, specific include values such as `include=security` return HTTP 401 on free plans.",
                      "disabled": false
                    },
                    {
                      "key": "fields",
                      "value": "location.city,security.threat_score,security.is_vpn",
                      "description": "Comma-separated list of fields or objects to return. Everything else is omitted. The `ip` field is always returned regardless of this filter.  Supports dot-notation for nested fields: `location.city`, `asn.organization`. To return an entire object, use the object key: `location`, `security`.  If a field belongs to an optional module (e.g. `security.threat_score`), you must also pass the corresponding `include` value. If you omit `include`, the request still succeeds, but fields from optional modules are not returned.  If the same field or object is specified in both `fields` and `excludes`, the object is still returned, but it will be empty. If the same field or object is specified in `include`, `fields`, and `excludes`, `include` takes priority over both `fields` and `excludes`.  If you list both an object key and one of its nested fields separated by comma (e.g. `security,security.threat_score`), the full object is returned.  Unknown field paths are ignored. The API still returns HTTP 200.  Available on all plans including Free.",
                      "disabled": true
                    },
                    {
                      "key": "excludes",
                      "value": "location.continent_code,currency,company.type",
                      "description": "Comma-separated list of fields or objects to remove from the response. The `ip` field cannot be excluded.  Supports dot-notation for nested fields: `location.continent_code`. To exclude an entire object, use the object key: `currency`, `time_zone`.  If the same field or object is specified in both `fields` and `excludes`, the object is still returned, but it will be empty. If the same field or object is specified in `include`, `fields`, and `excludes`, `include` takes priority over both `fields` and `excludes`.  Unknown fields or object keys in `excludes` are ignored. The API still returns HTTP 200.  Available on all plans including Free.",
                      "disabled": true
                    },
                    {
                      "key": "output",
                      "value": "json",
                      "description": "Desired response format. Defaults to `json` if not specified. You can also control the format using the `Accept` header (`application/json`, `application/xml`, or `text/xml`). If both are provided, the `output` parameter takes precedence.  If `output` is unknown or unsupported, it is ignored and the response defaults to JSON (`application/json`) with HTTP 200. Supported values: `json`, `xml`. Defaults to `json`.",
                      "disabled": true
                    }
                  ]
                }
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Credits-Charged",
                  "value": "1"
                }
              ],
              "body": "{\n  \"ip\": \"91.128.103.196\",\n  \"hostname\": \"91.128.103.196\",\n  \"location\": {\n    \"continent_code\": \"EU\",\n    \"continent_name\": \"Europe\",\n    \"country_code2\": \"SE\",\n    \"country_code3\": \"SWE\",\n    \"country_name\": \"Sweden\",\n    \"country_name_official\": \"Kingdom of Sweden\",\n    \"country_capital\": \"Stockholm\",\n    \"state_prov\": \"Stockholms län\",\n    \"state_code\": \"SE-AB\",\n    \"district\": \"Stockholm\",\n    \"city\": \"Stockholm\",\n    \"locality\": \"Stockholm\",\n    \"accuracy_radius\": \"4.395\",\n    \"confidence\": \"high\",\n    \"dma_code\": \"\",\n    \"zipcode\": \"164 40\",\n    \"latitude\": \"59.40510\",\n    \"longitude\": \"17.95510\",\n    \"is_eu\": true,\n    \"country_flag\": \"https://ipgeolocation.io/static/flags/se_64.png\",\n    \"geoname_id\": \"9972319\",\n    \"country_emoji\": \"🇸🇪\"\n  },\n  \"country_metadata\": {\n    \"calling_code\": \"+46\",\n    \"tld\": \".se\",\n    \"languages\": [\n      \"sv-SE\",\n      \"se\",\n      \"sma\",\n      \"fi-SE\"\n    ]\n  },\n  \"network\": {\n    \"connection_type\": \"\",\n    \"route\": \"91.128.0.0/14\",\n    \"is_anycast\": false\n  },\n  \"currency\": {\n    \"code\": \"SEK\",\n    \"name\": \"Swedish Krona\",\n    \"symbol\": \"kr\"\n  },\n  \"asn\": {\n    \"as_number\": \"AS1257\",\n    \"organization\": \"Tele2 Sverige AB\",\n    \"country\": \"SE\",\n    \"type\": \"ISP\",\n    \"domain\": \"tele2.com\",\n    \"date_allocated\": \"2024-12-13\",\n    \"rir\": \"RIPE\"\n  },\n  \"company\": {\n    \"name\": \"Tele2 Sverige AB\",\n    \"type\": \"ISP\",\n    \"domain\": \"tele2.com\"\n  },\n  \"security\": {\n    \"threat_score\": 0,\n    \"is_tor\": false,\n    \"is_proxy\": false,\n    \"proxy_provider_names\": [],\n    \"proxy_confidence_score\": 0,\n    \"proxy_last_seen\": \"\",\n    \"is_residential_proxy\": false,\n    \"is_vpn\": false,\n    \"vpn_provider_names\": [],\n    \"vpn_confidence_score\": 0,\n    \"vpn_last_seen\": \"\",\n    \"is_relay\": false,\n    \"relay_provider_name\": \"\",\n    \"is_anonymous\": false,\n    \"is_known_attacker\": false,\n    \"is_bot\": false,\n    \"is_spam\": false,\n    \"is_cloud_provider\": false,\n    \"cloud_provider_name\": \"\"\n  },\n  \"abuse\": {\n    \"route\": \"91.128.0.0/14\",\n    \"country\": \"SE\",\n    \"name\": \"Swipnet Staff\",\n    \"organization\": \"\",\n    \"kind\": \"group\",\n    \"address\": \"Tele2 AB/Swedish IP Network, IP Registry, Torshamnsgatan 17 164 40 Kista SWEDEN\",\n    \"emails\": [\n      \"abuse@tele2.com\"\n    ],\n    \"phone_numbers\": [\n      \"+46 8 5626 42 10\"\n    ]\n  },\n  \"time_zone\": {\n    \"name\": \"Europe/Stockholm\",\n    \"offset\": 1,\n    \"offset_with_dst\": 1,\n    \"current_time\": \"2026-02-13 09:19:24.410+0100\",\n    \"current_time_unix\": 1770970764.41,\n    \"current_tz_abbreviation\": \"CET\",\n    \"current_tz_full_name\": \"Central European Standard Time\",\n    \"standard_tz_abbreviation\": \"CET\",\n    \"standard_tz_full_name\": \"Central European Standard Time\",\n    \"is_dst\": false,\n    \"dst_savings\": 0,\n    \"dst_exists\": true,\n    \"dst_tz_abbreviation\": \"CEST\",\n    \"dst_tz_full_name\": \"Central European Summer Time\",\n    \"dst_start\": {\n      \"utc_time\": \"2026-03-29 TIME 01:00\",\n      \"duration\": \"+1.00H\",\n      \"gap\": true,\n      \"date_time_after\": \"2026-03-29 TIME 03:00\",\n      \"date_time_before\": \"2026-03-29 TIME 02:00\",\n      \"overlap\": false\n    },\n    \"dst_end\": {\n      \"utc_time\": \"2026-10-25 TIME 01:00\",\n      \"duration\": \"-1.00H\",\n      \"gap\": false,\n      \"date_time_after\": \"2026-10-25 TIME 02:00\",\n      \"date_time_before\": \"2026-10-25 TIME 03:00\",\n      \"overlap\": true\n    }\n  },\n  \"user_agent\": {\n    \"user_agent_string\": \"Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/143.0.0.0 Safari/537.36 Edg/143.0.0.0\",\n    \"name\": \"Edge\",\n    \"type\": \"Browser\",\n    \"version\": \"143\",\n    \"version_major\": \"143\",\n    \"device\": {\n      \"name\": \"Linux Desktop\",\n      \"type\": \"Desktop\",\n      \"brand\": \"Unknown\",\n      \"cpu\": \"Intel x86_64\"\n    },\n    \"engine\": {\n      \"name\": \"Blink\",\n      \"type\": \"Browser\",\n      \"version\": \"143\",\n      \"version_major\": \"143\"\n    },\n    \"operating_system\": {\n      \"name\": \"Linux\",\n      \"type\": \"Desktop\",\n      \"version\": \"??\",\n      \"version_major\": \"??\",\n      \"build\": \"??\"\n    }\n  }\n}"
            },
            {
              "name": "200 OK – Free plan default response",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "https://api.ipgeolocation.io/v3/ipgeo",
                  "protocol": "https",
                  "host": [
                    "api",
                    "ipgeolocation",
                    "io"
                  ],
                  "path": [
                    "v3",
                    "ipgeo"
                  ],
                  "query": [
                    {
                      "key": "ip",
                      "value": "165.227.0.0",
                      "description": "An IPv4 address, IPv6 address, or domain name to look up. When omitted, the API resolves the public IP of the requesting client. Empty or whitespace-only values are treated the same as omission and resolve caller IP. Domain lookups require a paid plan. Pass `ip` only once. If multiple `ip` query parameters are sent, values may be merged and treated as invalid input (HTTP 400).",
                      "disabled": false
                    },
                    {
                      "key": "fields",
                      "value": "location.city",
                      "description": "Comma-separated list of fields or objects to return. Everything else is omitted. The `ip` field is always returned regardless of this filter.  Supports dot-notation for nested fields: `location.city`, `asn.organization`. To return an entire object, use the object key: `location`, `security`.  If a field belongs to an optional module (e.g. `security.threat_score`), you must also pass the corresponding `include` value. If you omit `include`, the request still succeeds, but fields from optional modules are not returned.  If the same field or object is specified in both `fields` and `excludes`, the object is still returned, but it will be empty. If the same field or object is specified in `include`, `fields`, and `excludes`, `include` takes priority over both `fields` and `excludes`.  If you list both an object key and one of its nested fields separated by comma (e.g. `security,security.threat_score`), the full object is returned.  Unknown field paths are ignored. The API still returns HTTP 200.  Available on all plans including Free.",
                      "disabled": true
                    },
                    {
                      "key": "excludes",
                      "value": "location.continent_code,currency",
                      "description": "Comma-separated list of fields or objects to remove from the response. The `ip` field cannot be excluded.  Supports dot-notation for nested fields: `location.continent_code`. To exclude an entire object, use the object key: `currency`, `time_zone`.  If the same field or object is specified in both `fields` and `excludes`, the object is still returned, but it will be empty. If the same field or object is specified in `include`, `fields`, and `excludes`, `include` takes priority over both `fields` and `excludes`.  Unknown fields or object keys in `excludes` are ignored. The API still returns HTTP 200.  Available on all plans including Free.",
                      "disabled": true
                    },
                    {
                      "key": "output",
                      "value": "json",
                      "description": "Desired response format. Defaults to `json` if not specified. You can also control the format using the `Accept` header (`application/json`, `application/xml`, or `text/xml`). If both are provided, the `output` parameter takes precedence.  If `output` is unknown or unsupported, it is ignored and the response defaults to JSON (`application/json`) with HTTP 200. Supported values: `json`, `xml`. Defaults to `json`.",
                      "disabled": true
                    }
                  ]
                }
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Credits-Charged",
                  "value": "1"
                }
              ],
              "body": "{\n  \"ip\": \"165.227.0.0\",\n  \"location\": {\n    \"continent_code\": \"NA\",\n    \"continent_name\": \"North America\",\n    \"country_code2\": \"US\",\n    \"country_code3\": \"USA\",\n    \"country_name\": \"United States\",\n    \"country_name_official\": \"United States of America\",\n    \"country_capital\": \"Washington, D.C.\",\n    \"state_prov\": \"California\",\n    \"state_code\": \"US-CA\",\n    \"district\": \"Santa Clara County\",\n    \"city\": \"Santa Clara\",\n    \"zipcode\": \"95051\",\n    \"latitude\": \"37.35983\",\n    \"longitude\": \"-121.98144\",\n    \"is_eu\": false,\n    \"country_flag\": \"https://ipgeolocation.io/static/flags/us_64.png\",\n    \"geoname_id\": \"5346804\",\n    \"country_emoji\": \"🇺🇸\"\n  },\n  \"country_metadata\": {\n    \"calling_code\": \"+1\",\n    \"tld\": \".us\",\n    \"languages\": [\n      \"en-US\",\n      \"es-US\",\n      \"haw\",\n      \"fr\"\n    ]\n  },\n  \"currency\": {\n    \"code\": \"USD\",\n    \"name\": \"US Dollar\",\n    \"symbol\": \"$\"\n  },\n  \"asn\": {\n    \"as_number\": \"AS14061\",\n    \"organization\": \"DigitalOcean, LLC\",\n    \"country\": \"US\"\n  },\n  \"time_zone\": {\n    \"name\": \"America/Los_Angeles\",\n    \"offset\": -8,\n    \"offset_with_dst\": -8,\n    \"current_time\": \"2026-02-09 09:54:51.206-0800\",\n    \"current_time_unix\": 1770659691.206,\n    \"current_tz_abbreviation\": \"PST\",\n    \"current_tz_full_name\": \"Pacific Standard Time\",\n    \"standard_tz_abbreviation\": \"PST\",\n    \"standard_tz_full_name\": \"Pacific Standard Time\",\n    \"is_dst\": false,\n    \"dst_savings\": 0,\n    \"dst_exists\": true,\n    \"dst_tz_abbreviation\": \"PDT\",\n    \"dst_tz_full_name\": \"Pacific Daylight Time\",\n    \"dst_start\": {\n      \"utc_time\": \"2026-03-08 TIME 10:00\",\n      \"duration\": \"+1.00H\",\n      \"gap\": true,\n      \"date_time_after\": \"2026-03-08 TIME 03:00\",\n      \"date_time_before\": \"2026-03-08 TIME 02:00\",\n      \"overlap\": false\n    },\n    \"dst_end\": {\n      \"utc_time\": \"2026-11-01 TIME 09:00\",\n      \"duration\": \"-1.00H\",\n      \"gap\": false,\n      \"date_time_after\": \"2026-11-01 TIME 01:00\",\n      \"date_time_before\": \"2026-11-01 TIME 02:00\",\n      \"overlap\": true\n    }\n  }\n}"
            },
            {
              "name": "400 Bad Request – Invalid IP or parameter",
              "originalRequest": {},
              "status": "Bad Request",
              "code": 400,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"message\": \"Provided name, service or IP address 'not_an_ip' is not valid.\"\n}"
            },
            {
              "name": "401 Unauthorized – Invalid or missing API key",
              "originalRequest": {},
              "status": "Unauthorized",
              "code": 401,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"message\": \"Provided API key is not valid. Contact technical support for assistance at support@ipgeolocation.io\"\n}"
            },
            {
              "name": "401 Unauthorized – Free plan restriction",
              "originalRequest": {},
              "status": "Unauthorized",
              "code": 401,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"message\": \"This feature is not supported on your subscription. This feature is available on Paid subscriptions only.\"\n}"
            },
            {
              "name": "404 Not found– Not in our Database",
              "originalRequest": {},
              "status": "Not Found",
              "code": 404,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"message\": \"Provided IPv4 or IPv6 address does not exist in our database.\"\n}"
            },
            {
              "name": "405 Method Not Allowed – Post used on single endpoint",
              "originalRequest": {},
              "status": "Method Not Allowed",
              "code": 405,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"message\": \"Request method 'POST' is not supported\"\n}"
            },
            {
              "name": "423 Locked – Invalid IP range",
              "originalRequest": {},
              "status": "Locked",
              "code": 423,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"message\": \"'10.0.0.1' is a bogon IP address.\"\n}"
            },
            {
              "name": "429 Too Many Requests – Rate limit hit",
              "originalRequest": {},
              "status": "Too Many Requests",
              "code": 429,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"message\": \"You have exceeded the limit of PLAN_USAGE_LIMIT requests per PLAN_INERVAL for your subscribed PLAN plan. Please throttle your requests or upgrade your plan to continue using IPGeolocation API without interruption.\"\n}"
            },
            {
              "name": "499 Client Closed Request",
              "originalRequest": {},
              "status": "Client Closed Request",
              "code": 499,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"message\": \"Client closed the request before the server could respond.\"\n}"
            },
            {
              "name": "500 Internal Server Error",
              "originalRequest": {},
              "status": "Internal Server Error",
              "code": 500,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"message\": \"Something went wrong on the server side.\"\n}"
            }
          ]
        },
        {
          "name": "Bulk IP Geolocation Lookup",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "https://api.ipgeolocation.io/v3/ipgeo-bulk",
              "protocol": "https",
              "host": [
                "api",
                "ipgeolocation",
                "io"
              ],
              "path": [
                "v3",
                "ipgeo-bulk"
              ],
              "query": [
                {
                  "key": "lang",
                  "value": "en",
                  "description": "Language code for translated location names. Defaults to `en`. Non-English responses require a paid plan. Free plans always receive English regardless of this parameter. Unsupported `lang` values return HTTP 400. Language code. Supported values: `en`, `de`, `ru`, `ja`, `fr`, `cn`, `es`, `cs`, `it`, `ko`, `fa`, `pt`. Defaults to `en`.",
                  "disabled": true
                },
                {
                  "key": "include",
                  "value": "security",
                  "description": "Comma-separated list of optional data modules to add to the response. These are not returned by default. Requires a paid plan.  If multiple hostname options are passed in `include`, hostname resolution uses this precedence order: `liveHostname` first, then `hostname`, then `hostnameFallbackLive`. If none is specified, the `hostname` field is not returned.  For `user_agent`, the API parses the `User-Agent` header from the request. For server-side calls, forward your visitor's User-Agent string in the header so the parsed result matches the actual visitor.  For additional query parameters (`include`, `fields`, `excludes`, `output`), unknown values are ignored. The API still returns HTTP 200 and applies only recognized values.  Free plan behavior for `include=*`: the API returns HTTP 200 and ignores the include request, returning only base response fields. In contrast, specific include values such as `include=security` return HTTP 401 on free plans.",
                  "disabled": true
                },
                {
                  "key": "fields",
                  "value": "location.city,security.threat_score,security.is_vpn",
                  "description": "Comma-separated list of fields or objects to return. Everything else is omitted. The `ip` field is always returned regardless of this filter.  Supports dot-notation for nested fields: `location.city`, `asn.organization`. To return an entire object, use the object key: `location`, `security`.  If a field belongs to an optional module (e.g. `security.threat_score`), you must also pass the corresponding `include` value. If you omit `include`, the request still succeeds, but fields from optional modules are not returned.  If the same field or object is specified in both `fields` and `excludes`, the object is still returned, but it will be empty. If the same field or object is specified in `include`, `fields`, and `excludes`, `include` takes priority over both `fields` and `excludes`.  If you list both an object key and one of its nested fields separated by comma (e.g. `security,security.threat_score`), the full object is returned.  Unknown field paths are ignored. The API still returns HTTP 200.  Available on all plans including Free.",
                  "disabled": true
                },
                {
                  "key": "excludes",
                  "value": "location.continent_code,currency,company.type",
                  "description": "Comma-separated list of fields or objects to remove from the response. The `ip` field cannot be excluded.  Supports dot-notation for nested fields: `location.continent_code`. To exclude an entire object, use the object key: `currency`, `time_zone`.  If the same field or object is specified in both `fields` and `excludes`, the object is still returned, but it will be empty. If the same field or object is specified in `include`, `fields`, and `excludes`, `include` takes priority over both `fields` and `excludes`.  Unknown fields or object keys in `excludes` are ignored. The API still returns HTTP 200.  Available on all plans including Free.",
                  "disabled": true
                },
                {
                  "key": "output",
                  "value": "json",
                  "description": "Desired response format. Defaults to `json` if not specified. You can also control the format using the `Accept` header (`application/json`, `application/xml`, or `text/xml`). If both are provided, the `output` parameter takes precedence.  If `output` is unknown or unsupported, it is ignored and the response defaults to JSON (`application/json`) with HTTP 200. Supported values: `json`, `xml`. Defaults to `json`.",
                  "disabled": true
                }
              ]
            },
            "description": "Returns geolocation and enrichment data for up to 50,000 IPv4 addresses, IPv6\naddresses, or domain names in a single request. The request body must be a JSON\nobject with an `ips` array.\n\nThis endpoint requires a paid plan. Calling it with a free\nplan API key returns HTTP 401.\n\nThe response is a JSON array with one element per IP in the request. Each element\nis either a full geolocation response object or an error object with only a\n`message` field. Invalid, bogon, and unresolvable entries appear as error\nobjects. Invalid, private, and bogon IPs are not billed.\n\nThis endpoint supports the same query parameters as the single lookup endpoint,\nincluding `lang`, `include`, `fields`, `excludes`, and `output`.\n\nCredits are calculated as: credits per lookup multiplied by the number of valid\nIPs in the request. The total is returned in the `X-Credits-Charged` response\nheader. When at least one submitted ip is invalid, the `X-Successful-Record`\nresponse header indicates how many entries were successfully resolved.\n\nOnly the `POST` method is accepted. Sending a `GET` request returns HTTP 405.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"ips\": [\n    \"8.8.8.8\",\n    \"91.128.103.196\",\n    \"2607:fb91:16c6:8860:e531:2d1d:4944:6c7c\",\n    \"ipgeolocation.io\"\n  ]\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": [
            {
              "name": "200 OK – Bulk response with one valid and one error entry",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "https://api.ipgeolocation.io/v3/ipgeo-bulk",
                  "protocol": "https",
                  "host": [
                    "api",
                    "ipgeolocation",
                    "io"
                  ],
                  "path": [
                    "v3",
                    "ipgeo-bulk"
                  ],
                  "query": [
                    {
                      "key": "lang",
                      "value": "en",
                      "description": "Language code for translated location names. Defaults to `en`. Non-English responses require a paid plan. Free plans always receive English regardless of this parameter. Unsupported `lang` values return HTTP 400. Language code. Supported values: `en`, `de`, `ru`, `ja`, `fr`, `cn`, `es`, `cs`, `it`, `ko`, `fa`, `pt`. Defaults to `en`.",
                      "disabled": true
                    },
                    {
                      "key": "include",
                      "value": "*",
                      "description": "Comma-separated list of optional data modules to add to the response. These are not returned by default. Requires a paid plan.  If multiple hostname options are passed in `include`, hostname resolution uses this precedence order: `liveHostname` first, then `hostname`, then `hostnameFallbackLive`. If none is specified, the `hostname` field is not returned.  For `user_agent`, the API parses the `User-Agent` header from the request. For server-side calls, forward your visitor's User-Agent string in the header so the parsed result matches the actual visitor.  For additional query parameters (`include`, `fields`, `excludes`, `output`), unknown values are ignored. The API still returns HTTP 200 and applies only recognized values.  Free plan behavior for `include=*`: the API returns HTTP 200 and ignores the include request, returning only base response fields. In contrast, specific include values such as `include=security` return HTTP 401 on free plans.",
                      "disabled": true
                    },
                    {
                      "key": "fields",
                      "value": "location.city,security.threat_score,security.is_vpn",
                      "description": "Comma-separated list of fields or objects to return. Everything else is omitted. The `ip` field is always returned regardless of this filter.  Supports dot-notation for nested fields: `location.city`, `asn.organization`. To return an entire object, use the object key: `location`, `security`.  If a field belongs to an optional module (e.g. `security.threat_score`), you must also pass the corresponding `include` value. If you omit `include`, the request still succeeds, but fields from optional modules are not returned.  If the same field or object is specified in both `fields` and `excludes`, the object is still returned, but it will be empty. If the same field or object is specified in `include`, `fields`, and `excludes`, `include` takes priority over both `fields` and `excludes`.  If you list both an object key and one of its nested fields separated by comma (e.g. `security,security.threat_score`), the full object is returned.  Unknown field paths are ignored. The API still returns HTTP 200.  Available on all plans including Free.",
                      "disabled": true
                    },
                    {
                      "key": "excludes",
                      "value": "location.continent_code,currency,company.type",
                      "description": "Comma-separated list of fields or objects to remove from the response. The `ip` field cannot be excluded.  Supports dot-notation for nested fields: `location.continent_code`. To exclude an entire object, use the object key: `currency`, `time_zone`.  If the same field or object is specified in both `fields` and `excludes`, the object is still returned, but it will be empty. If the same field or object is specified in `include`, `fields`, and `excludes`, `include` takes priority over both `fields` and `excludes`.  Unknown fields or object keys in `excludes` are ignored. The API still returns HTTP 200.  Available on all plans including Free.",
                      "disabled": true
                    },
                    {
                      "key": "output",
                      "value": "json",
                      "description": "Desired response format. Defaults to `json` if not specified. You can also control the format using the `Accept` header (`application/json`, `application/xml`, or `text/xml`). If both are provided, the `output` parameter takes precedence.  If `output` is unknown or unsupported, it is ignored and the response defaults to JSON (`application/json`) with HTTP 200. Supported values: `json`, `xml`. Defaults to `json`.",
                      "disabled": true
                    }
                  ]
                },
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"ips\": [\n    \"8.8.8.8\",\n    \"10.0.0.1\"\n  ]\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Credits-Charged",
                  "value": "1"
                }
              ],
              "body": "[\n  {\n    \"ip\": \"8.8.8.8\",\n    \"location\": {\n      \"continent_code\": \"NA\",\n      \"continent_name\": \"North America\",\n      \"country_code2\": \"US\",\n      \"country_code3\": \"USA\",\n      \"country_name\": \"United States\",\n      \"country_name_official\": \"United States of America\",\n      \"country_capital\": \"Washington, D.C.\",\n      \"state_prov\": \"California\",\n      \"state_code\": \"US-CA\",\n      \"district\": \"Santa Clara County\",\n      \"city\": \"Mountain View\",\n      \"zipcode\": \"94043\",\n      \"latitude\": \"37.42240\",\n      \"longitude\": \"-122.08421\",\n      \"is_eu\": false,\n      \"country_flag\": \"https://ipgeolocation.io/static/flags/us_64.png\",\n      \"geoname_id\": \"5375480\",\n      \"country_emoji\": \"🇺🇸\"\n    },\n    \"country_metadata\": {\n      \"calling_code\": \"+1\",\n      \"tld\": \".us\",\n      \"languages\": [\n        \"en-US\",\n        \"es-US\",\n        \"haw\",\n        \"fr\"\n      ]\n    },\n    \"network\": {\n      \"connection_type\": \"\",\n      \"route\": \"8.8.8.0/24\",\n      \"is_anycast\": true\n    },\n    \"currency\": {\n      \"code\": \"USD\",\n      \"name\": \"US Dollar\",\n      \"symbol\": \"$\"\n    },\n    \"asn\": {\n      \"as_number\": \"AS15169\",\n      \"organization\": \"Google LLC\",\n      \"country\": \"US\",\n      \"type\": \"BUSINESS\",\n      \"domain\": \"google.com\",\n      \"date_allocated\": \"2000-03-30\",\n      \"rir\": \"ARIN\"\n    },\n    \"company\": {\n      \"name\": \"Google LLC\",\n      \"type\": \"HOSTING\",\n      \"domain\": \"google.com\"\n    },\n    \"time_zone\": {\n      \"name\": \"America/Los_Angeles\",\n      \"offset\": -8,\n      \"offset_with_dst\": -8,\n      \"current_time\": \"2026-02-09 09:54:51.206-0800\",\n      \"current_time_unix\": 1770659691.206,\n      \"current_tz_abbreviation\": \"PST\",\n      \"current_tz_full_name\": \"Pacific Standard Time\",\n      \"standard_tz_abbreviation\": \"PST\",\n      \"standard_tz_full_name\": \"Pacific Standard Time\",\n      \"is_dst\": false,\n      \"dst_savings\": 0,\n      \"dst_exists\": true,\n      \"dst_tz_abbreviation\": \"PDT\",\n      \"dst_tz_full_name\": \"Pacific Daylight Time\",\n      \"dst_start\": {\n        \"utc_time\": \"2026-03-08 TIME 10:00\",\n        \"duration\": \"+1.00H\",\n        \"gap\": true,\n        \"date_time_after\": \"2026-03-08 TIME 03:00\",\n        \"date_time_before\": \"2026-03-08 TIME 02:00\",\n        \"overlap\": false\n      },\n      \"dst_end\": {\n        \"utc_time\": \"2026-11-01 TIME 09:00\",\n        \"duration\": \"-1.00H\",\n        \"gap\": false,\n        \"date_time_after\": \"2026-11-01 TIME 01:00\",\n        \"date_time_before\": \"2026-11-01 TIME 02:00\",\n        \"overlap\": true\n      }\n    }\n  },\n  {\n    \"message\": \"'10.0.0.1' is a bogon IP address.\"\n  }\n]"
            },
            {
              "name": "400 Bad Request – Invalid IP or parameter",
              "originalRequest": {},
              "status": "Bad Request",
              "code": 400,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"message\": \"Provided name, service or IP address 'not_an_ip' is not valid.\"\n}"
            },
            {
              "name": "400 Bad Request – Empty array",
              "originalRequest": {},
              "status": "Bad Request",
              "code": 400,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"message\": \"'ips' must not be empty or null\"\n}"
            },
            {
              "name": "400 Bad Request – Exceeded 50,000 entries",
              "originalRequest": {},
              "status": "Bad Request",
              "code": 400,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"message\": \"No. of lookup queries cannot be more than 50000\"\n}"
            },
            {
              "name": "401 Unauthorized – Invalid or missing API key",
              "originalRequest": {},
              "status": "Unauthorized",
              "code": 401,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"message\": \"Provided API key is not valid. Contact technical support for assistance at support@ipgeolocation.io\"\n}"
            },
            {
              "name": "401 Unauthorized – Free plan restriction",
              "originalRequest": {},
              "status": "Unauthorized",
              "code": 401,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"message\": \"Bulk IP to geolocation lookup is not supported on your current subscription. This feature is available to all paid subscriptions only.\"\n}"
            },
            {
              "name": "405 Method Not Allowed – GET used on bulk endpoint",
              "originalRequest": {},
              "status": "Method Not Allowed",
              "code": 405,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"message\": \"Request method 'GET' is not supported\"\n}"
            },
            {
              "name": "413 Payload Too Large – Returned by nginx",
              "originalRequest": {},
              "status": "Payload Too Large",
              "code": 413,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"message\": \"413 Request Entity Too Large\"\n}"
            },
            {
              "name": "415 Unsupported Media Type – `Content-Type` not correct",
              "originalRequest": {},
              "status": "Unsupported Media Type",
              "code": 415,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"message\": \"Content-Type 'application/x-www-form-urlencoded' is not supported\"\n}"
            },
            {
              "name": "429 Too Many Requests – Rate limit hit",
              "originalRequest": {},
              "status": "Too Many Requests",
              "code": 429,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"message\": \"You have exceeded the limit of PLAN_USAGE_LIMIT requests per PLAN_INERVAL for your subscribed PLAN plan. Please throttle your requests or upgrade your plan to continue using IPGeolocation API without interruption.\"\n}"
            },
            {
              "name": "499 Client Closed Request",
              "originalRequest": {},
              "status": "Client Closed Request",
              "code": 499,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"message\": \"Client closed the request before the server could respond.\"\n}"
            },
            {
              "name": "500 Internal Server Error",
              "originalRequest": {},
              "status": "Internal Server Error",
              "code": 500,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"message\": \"Something went wrong on the server side.\"\n}"
            }
          ]
        }
      ]
    },
    {
      "name": "IP Security API",
      "description": "IP security intelligence endpoints used to detect VPNs,\nproxies, Tor exit nodes, relay networks, bot activity,\nspam activity, cloud providers, and other anonymization\ntechnologies associated with IP addresses.\n\nThe single lookup endpoint (`GET /v3/security`) analyzes\none IP per request.\n\nThe bulk lookup endpoint (`POST /v3/security-bulk`)\naccepts up to 50,000 IP addresses per request.",
      "item": [
        {
          "name": "Single IP Security Lookup",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "https://api.ipgeolocation.io/v3/security",
              "protocol": "https",
              "host": [
                "api",
                "ipgeolocation",
                "io"
              ],
              "path": [
                "v3",
                "security"
              ],
              "query": [
                {
                  "key": "ip",
                  "value": "8.8.8.8",
                  "description": "An IPv4 address or IPv6 address to look up. When omitted, the API resolves the public IP of the requesting client. Empty or whitespace-only values are treated the same as omission and resolve caller IP. Pass `ip` only once. If multiple `ip` query parameters are sent, values may be merged and treated as invalid input (HTTP 400).",
                  "disabled": true
                },
                {
                  "key": "fields",
                  "value": "security.is_tor,security.is_vpn",
                  "description": "Comma-separated list of fields or objects to return. Everything else is omitted. The `ip` field is always returned regardless of this filter.  Supports dot-notation for nested fields: `security.is_tor`, `security.threat_score`.  If the same field or object is specified in both `fields` and `excludes`, the object is still returned, but it will be empty.  If you list both an object key and one of its nested fields separated by comma (e.g. `security,security.is_vpn`), the full object is returned.  Unknown field paths are ignored. The API still returns HTTP 200.  Available on all plans including Free.",
                  "disabled": true
                },
                {
                  "key": "excludes",
                  "value": "security.proxy_provider_names,security.is_residential_proxy",
                  "description": "Comma-separated list of fields or objects to remove from the response. The `ip` field cannot be excluded.  Supports dot-notation for nested fields: `security.is_relay`.  If the same field or object is specified in both `fields` and `excludes`, the object is still returned, but it will be empty.  Unknown fields or object keys in `excludes` are ignored. The API still returns HTTP 200.  Available on all plans including Free.",
                  "disabled": true
                },
                {
                  "key": "output",
                  "value": "json",
                  "description": "Desired response format. Defaults to `json` if not specified. You can also control the format using the `Accept` header (`application/json`, `application/xml`, or `text/xml`). If both are provided, the `output` parameter takes precedence.  If `output` is unknown or unsupported, it is ignored and the response defaults to JSON (`application/json`) with HTTP 200. Supported values: `json`, `xml`. Defaults to `json`.",
                  "disabled": true
                }
              ]
            },
            "description": "Returns threat intelligence and anonymization signals for a single\nIPv4 or IPv6 address.\n\nIf the `ip` parameter is omitted, the API automatically detects the\ncaller's public IP address and returns its security risk signals.\n\nThe response includes a threat score and multiple indicators such\nas VPN usage, proxy usage, Tor exit node detection, relay networks,\nbot activity, spam activity, and cloud hosting infrastructure.\n\nWhen available, provider names, confidence scores, and last-seen\ntimestamps are included.\n\nUse the `fields` and `excludes` parameters to control which parts\nof the response are returned."
          },
          "response": [
            {
              "name": "200 OK – Success",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "https://api.ipgeolocation.io/v3/security",
                  "protocol": "https",
                  "host": [
                    "api",
                    "ipgeolocation",
                    "io"
                  ],
                  "path": [
                    "v3",
                    "security"
                  ],
                  "query": [
                    {
                      "key": "ip",
                      "value": "2.56.188.34",
                      "description": "An IPv4 address or IPv6 address to look up. When omitted, the API resolves the public IP of the requesting client. Empty or whitespace-only values are treated the same as omission and resolve caller IP. Pass `ip` only once. If multiple `ip` query parameters are sent, values may be merged and treated as invalid input (HTTP 400).",
                      "disabled": false
                    },
                    {
                      "key": "fields",
                      "value": "security.is_tor,security.is_vpn",
                      "description": "Comma-separated list of fields or objects to return. Everything else is omitted. The `ip` field is always returned regardless of this filter.  Supports dot-notation for nested fields: `security.is_tor`, `security.threat_score`.  If the same field or object is specified in both `fields` and `excludes`, the object is still returned, but it will be empty.  If you list both an object key and one of its nested fields separated by comma (e.g. `security,security.is_vpn`), the full object is returned.  Unknown field paths are ignored. The API still returns HTTP 200.  Available on all plans including Free.",
                      "disabled": true
                    },
                    {
                      "key": "excludes",
                      "value": "security.proxy_provider_names,security.is_residential_proxy",
                      "description": "Comma-separated list of fields or objects to remove from the response. The `ip` field cannot be excluded.  Supports dot-notation for nested fields: `security.is_relay`.  If the same field or object is specified in both `fields` and `excludes`, the object is still returned, but it will be empty.  Unknown fields or object keys in `excludes` are ignored. The API still returns HTTP 200.  Available on all plans including Free.",
                      "disabled": true
                    },
                    {
                      "key": "output",
                      "value": "json",
                      "description": "Desired response format. Defaults to `json` if not specified. You can also control the format using the `Accept` header (`application/json`, `application/xml`, or `text/xml`). If both are provided, the `output` parameter takes precedence.  If `output` is unknown or unsupported, it is ignored and the response defaults to JSON (`application/json`) with HTTP 200. Supported values: `json`, `xml`. Defaults to `json`.",
                      "disabled": true
                    }
                  ]
                }
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Credits-Charged",
                  "value": "1"
                }
              ],
              "body": "{\n  \"ip\": \"2.56.188.34\",\n  \"security\": {\n    \"threat_score\": 80,\n    \"is_tor\": false,\n    \"is_proxy\": true,\n    \"proxy_provider_names\": [\n      \"Zyte Proxy\"\n    ],\n    \"proxy_confidence_score\": 80,\n    \"proxy_last_seen\": \"2025-12-12\",\n    \"is_residential_proxy\": true,\n    \"is_vpn\": true,\n    \"vpn_provider_names\": [\n      \"Nord VPN\"\n    ],\n    \"vpn_confidence_score\": 80,\n    \"vpn_last_seen\": \"2026-01-19\",\n    \"is_relay\": false,\n    \"relay_provider_name\": \"\",\n    \"is_anonymous\": true,\n    \"is_known_attacker\": true,\n    \"is_bot\": false,\n    \"is_spam\": false,\n    \"is_cloud_provider\": true,\n    \"cloud_provider_name\": \"Packethub S.A.\"\n  }\n}"
            },
            {
              "name": "400 Bad Request – Invalid IP or parameter",
              "originalRequest": {},
              "status": "Bad Request",
              "code": 400,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"message\": \"Provided name, service or IP address 'not_an_ip' is not valid.\"\n}"
            },
            {
              "name": "401 Unauthorized – Invalid or missing API key",
              "originalRequest": {},
              "status": "Unauthorized",
              "code": 401,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"message\": \"Provided API key is not valid. Contact technical support for assistance at support@ipgeolocation.io.\"\n}"
            },
            {
              "name": "401 Unauthorized – Free plan restriction",
              "originalRequest": {},
              "status": "Unauthorized",
              "code": 401,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"message\": \"IP Security API is not supported on your current subscription. This feature is available on paid subscriptions only.\"\n}"
            },
            {
              "name": "404 Not found– Not in our Database",
              "originalRequest": {},
              "status": "Not Found",
              "code": 404,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"message\": \"Provided IPv4 or IPv6 address does not exist in our database.\"\n}"
            },
            {
              "name": "405 Method Not Allowed – Post used on single endpoint",
              "originalRequest": {},
              "status": "Method Not Allowed",
              "code": 405,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"message\": \"Request method 'POST' is not supported\"\n}"
            },
            {
              "name": "423 Locked – Invalid IP range",
              "originalRequest": {},
              "status": "Locked",
              "code": 423,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"message\": \"'10.0.0.1' is a bogon IP address.\"\n}"
            },
            {
              "name": "429 Too Many Requests – Rate limit hit",
              "originalRequest": {},
              "status": "Too Many Requests",
              "code": 429,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"message\": \"You have exceeded the limit of PLAN_USAGE_LIMIT requests per PLAN_INERVAL for your subscribed PLAN plan. Please throttle your requests or upgrade your plan to continue using IPGeolocation API without interruption.\"\n}"
            },
            {
              "name": "499 Client Closed Request",
              "originalRequest": {},
              "status": "Client Closed Request",
              "code": 499,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"message\": \"Client closed the request before the server could respond.\"\n}"
            },
            {
              "name": "500 Internal Server Error",
              "originalRequest": {},
              "status": "Internal Server Error",
              "code": 500,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"message\": \"Something went wrong on the server side.\"\n}"
            }
          ]
        },
        {
          "name": "Bulk IP Security Lookup",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "https://api.ipgeolocation.io/v3/security-bulk",
              "protocol": "https",
              "host": [
                "api",
                "ipgeolocation",
                "io"
              ],
              "path": [
                "v3",
                "security-bulk"
              ],
              "query": [
                {
                  "key": "fields",
                  "value": "security.is_tor,security.is_vpn",
                  "description": "Comma-separated list of fields or objects to return. Everything else is omitted. The `ip` field is always returned regardless of this filter.  Supports dot-notation for nested fields: `security.is_tor`, `security.threat_score`.  If the same field or object is specified in both `fields` and `excludes`, the object is still returned, but it will be empty.  If you list both an object key and one of its nested fields separated by comma (e.g. `security,security.is_vpn`), the full object is returned.  Unknown field paths are ignored. The API still returns HTTP 200.  Available on all plans including Free.",
                  "disabled": true
                },
                {
                  "key": "excludes",
                  "value": "security.proxy_provider_names,security.is_residential_proxy",
                  "description": "Comma-separated list of fields or objects to remove from the response. The `ip` field cannot be excluded.  Supports dot-notation for nested fields: `security.is_relay`.  If the same field or object is specified in both `fields` and `excludes`, the object is still returned, but it will be empty.  Unknown fields or object keys in `excludes` are ignored. The API still returns HTTP 200.  Available on all plans including Free.",
                  "disabled": true
                },
                {
                  "key": "output",
                  "value": "json",
                  "description": "Desired response format. Defaults to `json` if not specified. You can also control the format using the `Accept` header (`application/json`, `application/xml`, or `text/xml`). If both are provided, the `output` parameter takes precedence.  If `output` is unknown or unsupported, it is ignored and the response defaults to JSON (`application/json`) with HTTP 200. Supported values: `json`, `xml`. Defaults to `json`.",
                  "disabled": true
                }
              ]
            },
            "description": "Returns security intelligence for up to **50,000 IPv4 or IPv6\naddresses** in a single request.\n\nThe request body must contain an `ips` array.\n\nEach IP is processed independently. Invalid, bogon, or private\nIP addresses return an object containing only a `message` field.\n\nCredits are charged **per valid IP address** using the same\npricing rules as the single lookup endpoint.\n\nWhen at least one entry is invalid, the response header\n`X-Successful-Record` indicates the number of successful\nlookups.\n\nOnly the `POST` method is supported for this endpoint.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"ips\": [\n    \"8.8.8.8\",\n    \"91.128.103.196\",\n    \"2607:fb91:16c6:8860:e531:2d1d:4944:6c7c\"\n  ]\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": [
            {
              "name": "200 OK – Success",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "https://api.ipgeolocation.io/v3/security-bulk",
                  "protocol": "https",
                  "host": [
                    "api",
                    "ipgeolocation",
                    "io"
                  ],
                  "path": [
                    "v3",
                    "security-bulk"
                  ],
                  "query": [
                    {
                      "key": "fields",
                      "value": "security.is_tor,security.is_vpn",
                      "description": "Comma-separated list of fields or objects to return. Everything else is omitted. The `ip` field is always returned regardless of this filter.  Supports dot-notation for nested fields: `security.is_tor`, `security.threat_score`.  If the same field or object is specified in both `fields` and `excludes`, the object is still returned, but it will be empty.  If you list both an object key and one of its nested fields separated by comma (e.g. `security,security.is_vpn`), the full object is returned.  Unknown field paths are ignored. The API still returns HTTP 200.  Available on all plans including Free.",
                      "disabled": true
                    },
                    {
                      "key": "excludes",
                      "value": "security.proxy_provider_names,security.is_residential_proxy",
                      "description": "Comma-separated list of fields or objects to remove from the response. The `ip` field cannot be excluded.  Supports dot-notation for nested fields: `security.is_relay`.  If the same field or object is specified in both `fields` and `excludes`, the object is still returned, but it will be empty.  Unknown fields or object keys in `excludes` are ignored. The API still returns HTTP 200.  Available on all plans including Free.",
                      "disabled": true
                    },
                    {
                      "key": "output",
                      "value": "json",
                      "description": "Desired response format. Defaults to `json` if not specified. You can also control the format using the `Accept` header (`application/json`, `application/xml`, or `text/xml`). If both are provided, the `output` parameter takes precedence.  If `output` is unknown or unsupported, it is ignored and the response defaults to JSON (`application/json`) with HTTP 200. Supported values: `json`, `xml`. Defaults to `json`.",
                      "disabled": true
                    }
                  ]
                },
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"ips\": [\n    \"2.56.188.34\",\n    \"10.0.0.1\"\n  ]\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Credits-Charged",
                  "value": "1"
                }
              ],
              "body": "[\n  {\n    \"ip\": \"2.56.188.34\",\n    \"security\": {\n      \"threat_score\": 80,\n      \"is_tor\": false,\n      \"is_proxy\": true,\n      \"proxy_provider_names\": [\n        \"Zyte Proxy\"\n      ],\n      \"proxy_confidence_score\": 80,\n      \"proxy_last_seen\": \"2025-12-12\",\n      \"is_residential_proxy\": true,\n      \"is_vpn\": true,\n      \"vpn_provider_names\": [\n        \"Nord VPN\"\n      ],\n      \"vpn_confidence_score\": 80,\n      \"vpn_last_seen\": \"2026-01-19\",\n      \"is_relay\": false,\n      \"relay_provider_name\": \"\",\n      \"is_anonymous\": true,\n      \"is_known_attacker\": true,\n      \"is_bot\": false,\n      \"is_spam\": false,\n      \"is_cloud_provider\": true,\n      \"cloud_provider_name\": \"Packethub S.A.\"\n    }\n  },\n  {\n    \"message\": \"'10.0.0.1' is a bogon IP address.\"\n  }\n]"
            },
            {
              "name": "400 Bad Request – Invalid IP or parameter",
              "originalRequest": {},
              "status": "Bad Request",
              "code": 400,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"message\": \"Provided name, service or IP address 'not_an_ip' is not valid.\"\n}"
            },
            {
              "name": "400 Bad Request – Empty array",
              "originalRequest": {},
              "status": "Bad Request",
              "code": 400,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"message\": \"'ips' must not be empty or null\"\n}"
            },
            {
              "name": "400 Bad Request – Exceeded 50,000 entries",
              "originalRequest": {},
              "status": "Bad Request",
              "code": 400,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"message\": \"No. of lookup queries cannot be more than 50000\"\n}"
            },
            {
              "name": "401 Unauthorized – Invalid or missing API key",
              "originalRequest": {},
              "status": "Unauthorized",
              "code": 401,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"message\": \"Provided API key is not valid. Contact technical support for assistance at support@ipgeolocation.io.\"\n}"
            },
            {
              "name": "401 Unauthorized – Free plan restriction",
              "originalRequest": {},
              "status": "Unauthorized",
              "code": 401,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"message\": \"IP Security API is not supported on your current subscription. This feature is available on paid subscriptions only.\"\n}"
            },
            {
              "name": "405 Method Not Allowed – GET used on bulk endpoint",
              "originalRequest": {},
              "status": "Method Not Allowed",
              "code": 405,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"message\": \"Request method 'GET' is not supported. Please use POST.\"\n}"
            },
            {
              "name": "413 Payload Too Large – Returned by nginx",
              "originalRequest": {},
              "status": "Payload Too Large",
              "code": 413,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"message\": \"413 Request Entity Too Large\"\n}"
            },
            {
              "name": "415 Unsupported Media Type – `Content-Type` not correct",
              "originalRequest": {},
              "status": "Unsupported Media Type",
              "code": 415,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"message\": \"Content-Type 'application/x-www-form-urlencoded' is not supported\"\n}"
            },
            {
              "name": "429 Too Many Requests – Rate limit hit",
              "originalRequest": {},
              "status": "Too Many Requests",
              "code": 429,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"message\": \"You have exceeded the limit of PLAN_USAGE_LIMIT requests per PLAN_INERVAL for your subscribed PLAN plan. Please throttle your requests or upgrade your plan to continue using IPGeolocation API without interruption.\"\n}"
            },
            {
              "name": "499 Client Closed Request",
              "originalRequest": {},
              "status": "Client Closed Request",
              "code": 499,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"message\": \"Client closed the request before the server could respond.\"\n}"
            },
            {
              "name": "500 Internal Server Error",
              "originalRequest": {},
              "status": "Internal Server Error",
              "code": 500,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"message\": \"Something went wrong on the server side.\"\n}"
            }
          ]
        }
      ]
    },
    {
      "name": "ASN API",
      "description": "API endpoint for retrieving Autonomous System Number (ASN) information\nassociated with IPv4 addresses, IPv6 addresses, or specific ASN numbers.\n\nThe response includes ASN metadata such as the ASN number, organization\nname, country of registration, ASN type, domain, allocation details,\nrouting statistics, and the Regional Internet Registry (RIR) responsible\nfor the allocation.\n\nAdditional routing intelligence such as peers, upstreams, downstreams,\nannounced routes, and raw WHOIS registry data can also be retrieved\nusing the `include` parameter.\n\nThis information helps analyze internet routing, identify network\noperators, and understand how Autonomous Systems interconnect\nacross the internet.",
      "item": [
        {
          "name": "ASN Lookup",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "https://api.ipgeolocation.io/v3/asn",
              "protocol": "https",
              "host": [
                "api",
                "ipgeolocation",
                "io"
              ],
              "path": [
                "v3",
                "asn"
              ],
              "query": [
                {
                  "key": "ip",
                  "value": "8.8.8.8",
                  "description": "An IPv4 address or IPv6 address to look up. When omitted, the API resolves the public IP of the requesting client.  If the `asn` parameter is provided, the `ip` parameter must not be used, because the lookup will be performed directly using the specified ASN.  Empty or whitespace-only values are treated the same as omission and resolve the caller IP.  Pass `ip` only once. If multiple `ip` query parameters are sent, values may be merged and treated as invalid input (HTTP 400).",
                  "disabled": true
                },
                {
                  "key": "asn",
                  "value": "AS24940",
                  "description": "An Autonomous System Number (ASN) to look up.  When provided, the lookup is performed directly using the specified ASN, and the `ip` parameter must not be included in the request.  The API returns detailed information about the ASN including the organization name, country of registration, ASN type, routing statistics, and other related network metadata.  Pass `asn` only once. If multiple `asn` query parameters are sent, values may be merged and treated as invalid input (HTTP 400).",
                  "disabled": true
                },
                {
                  "key": "include",
                  "value": "peers",
                  "description": "Comma-separated list of optional data modules to add to the response. These are not returned by default.  Supported ASN modules include:  - `peers` - `downstreams` - `upstreams` - `routes` - `whois_response`  If multiple values are provided, they must be comma-separated.  For additional query parameters (`include`, `fields`, `excludes`, `output`), unknown values are ignored. The API still returns HTTP 200 and applies only recognized values.",
                  "disabled": true
                },
                {
                  "key": "fields",
                  "value": "asn.organization,asn.country",
                  "description": "Comma-separated list of fields or objects to return. Everything else is omitted. The `ip` field is always returned when the lookup is performed using an IP address.  Supports dot-notation for nested fields: `asn.organization`, `asn.domain`.  If the same field or object is specified in both `fields` and `excludes`, the object is still returned, but it will be empty.  If you list both an object key and one of its nested fields separated by comma (e.g. `asn,asn.organization`), the full object is returned.  Unknown field paths are ignored. The API still returns HTTP 200.  Available on all plans including Free.",
                  "disabled": true
                },
                {
                  "key": "excludes",
                  "value": "asn.date_allocated,asn.allocation_status",
                  "description": "Comma-separated list of fields or objects to remove from the response. The `ip` field cannot be excluded.  Supports dot-notation for nested fields: `asn.domain`.  If the same field or object is specified in both `fields` and `excludes`, the object is still returned, but it will be empty.  Unknown fields or object keys in `excludes` are ignored. The API still returns HTTP 200.  Available on all plans including Free.",
                  "disabled": true
                },
                {
                  "key": "output",
                  "value": "json",
                  "description": "Desired response format. Defaults to `json` if not specified. You can also control the format using the `Accept` header (`application/json`, `application/xml`, or `text/xml`). If both are provided, the `output` parameter takes precedence.  If `output` is unknown or unsupported, it is ignored and the response defaults to JSON (`application/json`) with HTTP 200. Supported values: `json`, `xml`. Defaults to `json`.",
                  "disabled": true
                }
              ]
            },
            "description": "Returns ASN details for a single IPv4 address, IPv6 address,\nor ASN number.\n\nThe response contains information about the Autonomous System\nresponsible for routing the queried IP address or ASN.\n\nBasic ASN metadata is always returned, while additional routing\nrelationships such as peers, upstreams, downstreams, routes,\nand WHOIS data can be retrieved using the `include` parameter.\n\nWhen the lookup is performed using the `asn` parameter,\nthe `ip` field is not included in the response.\n\nEach successful lookup consumes **1 credit**.\n\nUse the `fields`, `excludes`, and `include` parameters\nto customize the response."
          },
          "response": [
            {
              "name": "200 OK – Success",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "https://api.ipgeolocation.io/v3/asn",
                  "protocol": "https",
                  "host": [
                    "api",
                    "ipgeolocation",
                    "io"
                  ],
                  "path": [
                    "v3",
                    "asn"
                  ],
                  "query": [
                    {
                      "key": "ip",
                      "value": "2607:fb91:16c6:8860:e531:2d1d:4944:6c7c",
                      "description": "An IPv4 address or IPv6 address to look up. When omitted, the API resolves the public IP of the requesting client.  If the `asn` parameter is provided, the `ip` parameter must not be used, because the lookup will be performed directly using the specified ASN.  Empty or whitespace-only values are treated the same as omission and resolve the caller IP.  Pass `ip` only once. If multiple `ip` query parameters are sent, values may be merged and treated as invalid input (HTTP 400).",
                      "disabled": true
                    },
                    {
                      "key": "asn",
                      "value": "AS24940",
                      "description": "An Autonomous System Number (ASN) to look up.  When provided, the lookup is performed directly using the specified ASN, and the `ip` parameter must not be included in the request.  The API returns detailed information about the ASN including the organization name, country of registration, ASN type, routing statistics, and other related network metadata.  Pass `asn` only once. If multiple `asn` query parameters are sent, values may be merged and treated as invalid input (HTTP 400).",
                      "disabled": false
                    },
                    {
                      "key": "include",
                      "value": "peers,downstreams,upstreams,routes,whois_response",
                      "description": "Comma-separated list of optional data modules to add to the response. These are not returned by default.  Supported ASN modules include:  - `peers` - `downstreams` - `upstreams` - `routes` - `whois_response`  If multiple values are provided, they must be comma-separated.  For additional query parameters (`include`, `fields`, `excludes`, `output`), unknown values are ignored. The API still returns HTTP 200 and applies only recognized values.",
                      "disabled": false
                    },
                    {
                      "key": "fields",
                      "value": "asn.organization,asn.country",
                      "description": "Comma-separated list of fields or objects to return. Everything else is omitted. The `ip` field is always returned when the lookup is performed using an IP address.  Supports dot-notation for nested fields: `asn.organization`, `asn.domain`.  If the same field or object is specified in both `fields` and `excludes`, the object is still returned, but it will be empty.  If you list both an object key and one of its nested fields separated by comma (e.g. `asn,asn.organization`), the full object is returned.  Unknown field paths are ignored. The API still returns HTTP 200.  Available on all plans including Free.",
                      "disabled": true
                    },
                    {
                      "key": "excludes",
                      "value": "asn.date_allocated,asn.allocation_status",
                      "description": "Comma-separated list of fields or objects to remove from the response. The `ip` field cannot be excluded.  Supports dot-notation for nested fields: `asn.domain`.  If the same field or object is specified in both `fields` and `excludes`, the object is still returned, but it will be empty.  Unknown fields or object keys in `excludes` are ignored. The API still returns HTTP 200.  Available on all plans including Free.",
                      "disabled": true
                    },
                    {
                      "key": "output",
                      "value": "json",
                      "description": "Desired response format. Defaults to `json` if not specified. You can also control the format using the `Accept` header (`application/json`, `application/xml`, or `text/xml`). If both are provided, the `output` parameter takes precedence.  If `output` is unknown or unsupported, it is ignored and the response defaults to JSON (`application/json`) with HTTP 200. Supported values: `json`, `xml`. Defaults to `json`.",
                      "disabled": true
                    }
                  ]
                }
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Credits-Charged",
                  "value": "1"
                }
              ],
              "body": "{\n  \"asn\": {\n    \"as_number\": \"AS24940\",\n    \"organization\": \"Hetzner Online GmbH\",\n    \"country\": \"DE\",\n    \"type\": \"HOSTING\",\n    \"domain\": \"hetzner.com\",\n    \"date_allocated\": \"2002-06-03\",\n    \"asn_name\": \"HETZNER-AS\",\n    \"allocation_status\": \"ASSIGNED\",\n    \"num_of_ipv4_routes\": \"84\",\n    \"num_of_ipv6_routes\": \"6\",\n    \"rir\": \"RIPE\",\n    \"peers\": [\n      {\n        \"as_number\": \"AS58057\",\n        \"description\": \"Securebit A\",\n        \"country\": \"CH\"\n      },\n      {\n        \"as_number\": \"AS28792\",\n        \"description\": \"Public Internet Ltd\",\n        \"country\": \"GB\"\n      }\n    ],\n    \"routes\": [\n      \"78.46.0.0/15\",\n      \"138.199.128.0/17\"\n    ],\n    \"upstreams\": [\n      {\n        \"as_number\": \"AS12552\",\n        \"description\": \"GlobalConnect AB\",\n        \"country\": \"SE\"\n      },\n      {\n        \"as_number\": \"AS58057\",\n        \"description\": \"Securebit AG\",\n        \"country\": \"CH\"\n      }\n    ],\n    \"downstreams\": [\n      {\n        \"as_number\": \"AS209148\",\n        \"description\": \"Securepoint GmbH\",\n        \"country\": \"DE\"\n      },\n      {\n        \"as_number\": \"AS198167\",\n        \"description\": \"Apptc.me s.r.o.\",\n        \"country\": \"CZ\"\n      }\n    ],\n    \"whois_response\": \"#\\n# ARIN WHOIS data and services are subject to the Terms of Use\\n#\\nASNumber:       24940\\nASName:         HETZNER-AS\\nOrgName:        Hetzner Online GmbH\\nCountry:        DE\\n...\\n\"\n  }\n}"
            },
            {
              "name": "400 Bad Request – Invalid IP or parameter",
              "originalRequest": {},
              "status": "Bad Request",
              "code": 400,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"message\": \"Provided name, service or IP address 'not_an_ip' is not valid.\"\n}"
            },
            {
              "name": "401 Unauthorized – Invalid or missing API key",
              "originalRequest": {},
              "status": "Unauthorized",
              "code": 401,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"message\": \"Provided API key is not valid. Contact technical support for assistance at support@ipgeolocation.io\"\n}"
            },
            {
              "name": "401 Unauthorized – Free plan restriction",
              "originalRequest": {},
              "status": "Unauthorized",
              "code": 401,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"message\": \"ASN Lookup is not supported on your current subscription. This feature is available to Paid subscriptions only.\"\n}"
            },
            {
              "name": "404 Not found– Not in our Database",
              "originalRequest": {},
              "status": "Not Found",
              "code": 404,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"message\": \"Provided IPv4 or IPv6 address does not exist in our database.\"\n}"
            },
            {
              "name": "405 Method Not Allowed – Post used on single endpoint",
              "originalRequest": {},
              "status": "Method Not Allowed",
              "code": 405,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"message\": \"Request method 'POST' is not supported\"\n}"
            },
            {
              "name": "423 Locked – Invalid IP range",
              "originalRequest": {},
              "status": "Locked",
              "code": 423,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"message\": \"'10.0.0.1' is a bogon IP address.\"\n}"
            },
            {
              "name": "429 Too Many Requests – Rate limit hit",
              "originalRequest": {},
              "status": "Too Many Requests",
              "code": 429,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"message\": \"You have exceeded the limit of PLAN_USAGE_LIMIT requests per PLAN_INERVAL for your subscribed PLAN plan. Please throttle your requests or upgrade your plan to continue using IPGeolocation API without interruption.\"\n}"
            },
            {
              "name": "499 Client Closed Request",
              "originalRequest": {},
              "status": "Client Closed Request",
              "code": 499,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"message\": \"Client closed the request before the server could respond.\"\n}"
            },
            {
              "name": "500 Internal Server Error",
              "originalRequest": {},
              "status": "Internal Server Error",
              "code": 500,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"message\": \"Something went wrong on the server side.\"\n}"
            }
          ]
        }
      ]
    },
    {
      "name": "Abuse Contact API",
      "description": "API endpoint for retrieving abuse contact information associated\nwith IPv4 and IPv6 addresses. The response contains registry-based\ncontact details for reporting malicious or abusive network activity\nsuch as spam, phishing, DDoS attacks, or unauthorized access attempts.",
      "item": [
        {
          "name": "IP Abuse Contact Lookup",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "https://api.ipgeolocation.io/v3/abuse",
              "protocol": "https",
              "host": [
                "api",
                "ipgeolocation",
                "io"
              ],
              "path": [
                "v3",
                "abuse"
              ],
              "query": [
                {
                  "key": "ip",
                  "value": "8.8.8.8",
                  "description": "An IPv4 address or IPv6 address to look up. When omitted, the API resolves the public IP of the requesting client. Empty or whitespace-only values are treated the same as omission and resolve caller IP. Pass `ip` only once. If multiple `ip` query parameters are sent, values may be merged and treated as invalid input (HTTP 400).",
                  "disabled": true
                },
                {
                  "key": "fields",
                  "value": "abuse.name,abuse.organization",
                  "description": "Comma-separated list of fields or objects to return. Everything else is omitted. The `ip` field is always returned regardless of this filter.  Supports dot-notation for nested fields: `abuse.route`, `abuse.organization`.  If the same field or object is specified in both `fields` and `excludes`, the object is still returned, but it will be empty.  If you list both an object key and one of its nested fields separated by comma (e.g. `abuse,abuse.name`), the full object is returned.  Unknown field paths are ignored. The API still returns HTTP 200.  Available on all plans including Free.",
                  "disabled": true
                },
                {
                  "key": "excludes",
                  "value": "abuse.address,abuse.emails",
                  "description": "Comma-separated list of fields or objects to remove from the response. The `ip` field cannot be excluded.  Supports dot-notation for nested fields: `abuse.name`.  If the same field or object is specified in both `fields` and `excludes`, the object is still returned, but it will be empty.  Unknown fields or object keys in `excludes` are ignored. The API still returns HTTP 200.  Available on all plans including Free.",
                  "disabled": true
                },
                {
                  "key": "output",
                  "value": "json",
                  "description": "Desired response format. Defaults to `json` if not specified. You can also control the format using the `Accept` header (`application/json`, `application/xml`, or `text/xml`). If both are provided, the `output` parameter takes precedence.  If `output` is unknown or unsupported, it is ignored and the response defaults to JSON (`application/json`) with HTTP 200. Supported values: `json`, `xml`. Defaults to `json`.",
                  "disabled": true
                }
              ]
            },
            "description": "Returns abuse contact information for a single IPv4 or IPv6 address.\n\nThe response includes the organization responsible for handling abuse\ncomplaints related to the queried IP address. This typically contains\nthe abuse contact role, organization name, contact emails, phone\nnumbers, and the registered address.\n\nThis endpoint is intended for reporting malicious activities such as\nspam, phishing, DDoS attacks, and other network abuse.\n\nWhen only abuse contact information is required, using this endpoint is\nrecommended instead of `/v3/ipgeo?include=abuse` because it returns a\nsmaller response payload and predictable credit usage.\n\nEach successful lookup consumes **1 credit**.\n\nUse the `fields` and `excludes` parameters to control which parts of\nthe response are returned."
          },
          "response": [
            {
              "name": "200 OK – Success",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "https://api.ipgeolocation.io/v3/abuse",
                  "protocol": "https",
                  "host": [
                    "api",
                    "ipgeolocation",
                    "io"
                  ],
                  "path": [
                    "v3",
                    "abuse"
                  ],
                  "query": [
                    {
                      "key": "ip",
                      "value": "1.0.0.0",
                      "description": "An IPv4 address or IPv6 address to look up. When omitted, the API resolves the public IP of the requesting client. Empty or whitespace-only values are treated the same as omission and resolve caller IP. Pass `ip` only once. If multiple `ip` query parameters are sent, values may be merged and treated as invalid input (HTTP 400).",
                      "disabled": false
                    },
                    {
                      "key": "fields",
                      "value": "abuse.name,abuse.organization",
                      "description": "Comma-separated list of fields or objects to return. Everything else is omitted. The `ip` field is always returned regardless of this filter.  Supports dot-notation for nested fields: `abuse.route`, `abuse.organization`.  If the same field or object is specified in both `fields` and `excludes`, the object is still returned, but it will be empty.  If you list both an object key and one of its nested fields separated by comma (e.g. `abuse,abuse.name`), the full object is returned.  Unknown field paths are ignored. The API still returns HTTP 200.  Available on all plans including Free.",
                      "disabled": true
                    },
                    {
                      "key": "excludes",
                      "value": "abuse.address,abuse.emails",
                      "description": "Comma-separated list of fields or objects to remove from the response. The `ip` field cannot be excluded.  Supports dot-notation for nested fields: `abuse.name`.  If the same field or object is specified in both `fields` and `excludes`, the object is still returned, but it will be empty.  Unknown fields or object keys in `excludes` are ignored. The API still returns HTTP 200.  Available on all plans including Free.",
                      "disabled": true
                    },
                    {
                      "key": "output",
                      "value": "json",
                      "description": "Desired response format. Defaults to `json` if not specified. You can also control the format using the `Accept` header (`application/json`, `application/xml`, or `text/xml`). If both are provided, the `output` parameter takes precedence.  If `output` is unknown or unsupported, it is ignored and the response defaults to JSON (`application/json`) with HTTP 200. Supported values: `json`, `xml`. Defaults to `json`.",
                      "disabled": true
                    }
                  ]
                }
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Credits-Charged",
                  "value": "1"
                }
              ],
              "body": "{\n  \"ip\": \"1.0.0.0\",\n  \"abuse\": {\n    \"route\": \"91.128.0.0/14\",\n    \"country\": \"SE\",\n    \"name\": \"Swipnet Staff\",\n    \"organization\": \"\",\n    \"kind\": \"group\",\n    \"address\": \"Tele2 AB/Swedish IP Network, IP Registry, Torshamnsgatan 17 164 40 Kista SWEDEN\",\n    \"emails\": [\n      \"abuse@tele2.com\"\n    ],\n    \"phone_numbers\": [\n      \"+46 8 5626 42 10\"\n    ]\n  }\n}"
            },
            {
              "name": "400 Bad Request – Invalid IP or parameter",
              "originalRequest": {},
              "status": "Bad Request",
              "code": 400,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"message\": \"Provided name, service or IP address 'not_an_ip' is not valid.\"\n}"
            },
            {
              "name": "401 Unauthorized – Invalid or missing API key",
              "originalRequest": {},
              "status": "Unauthorized",
              "code": 401,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"message\": \"Provided API key is not valid. Contact technical support for assistance at support@ipgeolocation.io\"\n}"
            },
            {
              "name": "401 Unauthorized – Free plan restriction",
              "originalRequest": {},
              "status": "Unauthorized",
              "code": 401,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"message\": \"Abuse Lookup is not supported on your current subscription. This feature is available to Paid subscriptions only.\"\n}"
            },
            {
              "name": "404 Not found– Not in our Database",
              "originalRequest": {},
              "status": "Not Found",
              "code": 404,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"message\": \"Provided IPv4 or IPv6 address does not exist in our database.\"\n}"
            },
            {
              "name": "405 Method Not Allowed – Post used on single endpoint",
              "originalRequest": {},
              "status": "Method Not Allowed",
              "code": 405,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"message\": \"Request method 'POST' is not supported\"\n}"
            },
            {
              "name": "423 Locked – Invalid IP range",
              "originalRequest": {},
              "status": "Locked",
              "code": 423,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"message\": \"'10.0.0.1' is a bogon IP address.\"\n}"
            },
            {
              "name": "429 Too Many Requests – Rate limit hit",
              "originalRequest": {},
              "status": "Too Many Requests",
              "code": 429,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"message\": \"You have exceeded the limit of PLAN_USAGE_LIMIT requests per PLAN_INERVAL for your subscribed PLAN plan. Please throttle your requests or upgrade your plan to continue using IPGeolocation API without interruption.\"\n}"
            },
            {
              "name": "499 Client Closed Request",
              "originalRequest": {},
              "status": "Client Closed Request",
              "code": 499,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"message\": \"Client closed the request before the server could respond.\"\n}"
            },
            {
              "name": "500 Internal Server Error",
              "originalRequest": {},
              "status": "Internal Server Error",
              "code": 500,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"message\": \"Something went wrong on the server side.\"\n}"
            }
          ]
        }
      ]
    },
    {
      "name": "Timezone API",
      "description": "API endpoints for retrieving current date, time, and timezone\ninformation for a given input such as an IANA timezone identifier,\ngeographic coordinates, location address, IPv4 or IPv6 address,\nairport codes (IATA or ICAO), or UN/LOCODE.\n\nThe API can also convert timestamps between different timezones,\nlocations, coordinates, airports, or UN/LOCODE identifiers.\n\nResponses include detailed timezone metadata such as UTC offset,\ndaylight saving time (DST) status, formatted timestamps, and\nupcoming DST transition information. Depending on the lookup\nmethod used, the response may also include geolocation data,\nairport details, or city information.",
      "item": [
        {
          "name": "Timezone Lookup",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "https://api.ipgeolocation.io/v3/timezone",
              "protocol": "https",
              "host": [
                "api",
                "ipgeolocation",
                "io"
              ],
              "path": [
                "v3",
                "timezone"
              ],
              "query": [
                {
                  "key": "ip",
                  "value": "8.8.8.8",
                  "description": "An IPv4 address, IPv6 address, or domain name to look up. When omitted, the API resolves the public IP of the requesting client. Empty or whitespace-only values are treated the same as omission and resolve caller IP. Domain lookups require a paid plan. Pass `ip` only once. If multiple `ip` query parameters are sent, values may be merged and treated as invalid input (HTTP 400).",
                  "disabled": true
                },
                {
                  "key": "lang",
                  "value": "en",
                  "description": "Language code for translated location names. Defaults to `en`. Non-English responses require a paid plan. Free plans always receive English regardless of this parameter. Unsupported `lang` values return HTTP 400. Language code. Supported values: `en`, `de`, `ru`, `ja`, `fr`, `cn`, `es`, `cs`, `it`, `ko`, `fa`, `pt`. Defaults to `en`.",
                  "disabled": true
                },
                {
                  "key": "output",
                  "value": "json",
                  "description": "Desired response format. Defaults to `json` if not specified. You can also control the format using the `Accept` header (`application/json`, `application/xml`, or `text/xml`). If both are provided, the `output` parameter takes precedence.  If `output` is unknown or unsupported, it is ignored and the response defaults to JSON (`application/json`) with HTTP 200. Supported values: `json`, `xml`. Defaults to `json`.",
                  "disabled": true
                },
                {
                  "key": "lo_code",
                  "value": "DEBER",
                  "description": "UN/LOCODE used to determine the timezone of a city or location.  The code consists of a two-letter country code followed by three alphanumeric characters representing the location.  When used, the response includes a `lo_code_details` object alongside the `time_zone` object.",
                  "disabled": true
                },
                {
                  "key": "icao_code",
                  "value": "KATL",
                  "description": "Four-letter ICAO airport code used to determine the timezone of the airport location.  When used, the response includes an `airport_details` object containing airport metadata alongside the `time_zone` object.",
                  "disabled": true
                },
                {
                  "key": "iata_code",
                  "value": "LHR",
                  "description": "Three-letter IATA airport code used to determine the timezone of the airport location.  When used, the response includes an `airport_details` object containing airport metadata alongside the `time_zone` object.",
                  "disabled": true
                },
                {
                  "key": "long",
                  "value": "-74.006",
                  "description": "Longitude coordinate of the location used to determine the timezone. Must be provided together with the `lat` parameter.  Valid longitude values range from **-180 to 180**.",
                  "disabled": true
                },
                {
                  "key": "lat",
                  "value": "40.7128",
                  "description": "Latitude coordinate of the location used to determine the timezone. Must be provided together with the `long` parameter.  Valid latitude values range from **-90 to 90**.",
                  "disabled": true
                },
                {
                  "key": "location",
                  "value": "Lahore, Pakistan",
                  "description": "Address or location name used to determine the timezone.  Typically a city-level or region-level address such as `London, UK` or `New York, USA`.  When this parameter is used, the API returns a `location` object containing geolocation details alongside the `time_zone` object.",
                  "disabled": true
                },
                {
                  "key": "tz",
                  "value": "Australia/Lord_Howe",
                  "description": "IANA timezone identifier to retrieve timezone information.  When provided, the API returns the current date, time, and timezone metadata for the specified timezone.  If multiple lookup parameters are provided in the same request, the `tz` parameter takes the highest priority.  Example identifiers include `Europe/London`, `America/New_York`, and `Asia/Tokyo`.",
                  "disabled": true
                }
              ]
            },
            "description": "Returns current date, time, and timezone information for a\nspecific location or identifier.\n\nThe timezone can be resolved using one of several inputs,\nincluding an IANA timezone name (`tz`), geographic coordinates\n(`lat` and `long`), location address (`location`), IPv4 or IPv6\naddress (`ip`), airport codes (`iata_code` or `icao_code`), or\na UN/LOCODE (`lo_code`).\n\nDepending on the lookup method used, additional contextual\ninformation may also be returned in the response:\n\n- `location` object for IP address or location queries\n- `airport_details` object for IATA or ICAO code queries\n- `lo_code_details` object for UN/LOCODE queries\n\nIf multiple lookup parameters are provided in the same request,\nthe API resolves the timezone using the following priority order:\n\n1. `tz`\n2. `lat` and `long`\n3. `location`\n4. `ip`\n5. `iata_code`\n6. `icao_code`\n7. `lo_code`\n\nIf none of the lookup parameters are provided, the API resolves\nthe timezone using the public IP address of the requesting client.\n\nEach successful lookup consumes **1 credit**."
          },
          "response": [
            {
              "name": "200 OK – Success",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "https://api.ipgeolocation.io/v3/timezone",
                  "protocol": "https",
                  "host": [
                    "api",
                    "ipgeolocation",
                    "io"
                  ],
                  "path": [
                    "v3",
                    "timezone"
                  ],
                  "query": [
                    {
                      "key": "ip",
                      "value": "49.12.0.0",
                      "description": "An IPv4 address, IPv6 address, or domain name to look up. When omitted, the API resolves the public IP of the requesting client. Empty or whitespace-only values are treated the same as omission and resolve caller IP. Domain lookups require a paid plan. Pass `ip` only once. If multiple `ip` query parameters are sent, values may be merged and treated as invalid input (HTTP 400).",
                      "disabled": false
                    },
                    {
                      "key": "lang",
                      "value": "en",
                      "description": "Language code for translated location names. Defaults to `en`. Non-English responses require a paid plan. Free plans always receive English regardless of this parameter. Unsupported `lang` values return HTTP 400. Language code. Supported values: `en`, `de`, `ru`, `ja`, `fr`, `cn`, `es`, `cs`, `it`, `ko`, `fa`, `pt`. Defaults to `en`.",
                      "disabled": true
                    },
                    {
                      "key": "output",
                      "value": "json",
                      "description": "Desired response format. Defaults to `json` if not specified. You can also control the format using the `Accept` header (`application/json`, `application/xml`, or `text/xml`). If both are provided, the `output` parameter takes precedence.  If `output` is unknown or unsupported, it is ignored and the response defaults to JSON (`application/json`) with HTTP 200. Supported values: `json`, `xml`. Defaults to `json`.",
                      "disabled": true
                    },
                    {
                      "key": "lo_code",
                      "value": "DEBER",
                      "description": "UN/LOCODE used to determine the timezone of a city or location.  The code consists of a two-letter country code followed by three alphanumeric characters representing the location.  When used, the response includes a `lo_code_details` object alongside the `time_zone` object.",
                      "disabled": true
                    },
                    {
                      "key": "icao_code",
                      "value": "KATL",
                      "description": "Four-letter ICAO airport code used to determine the timezone of the airport location.  When used, the response includes an `airport_details` object containing airport metadata alongside the `time_zone` object.",
                      "disabled": true
                    },
                    {
                      "key": "iata_code",
                      "value": "LHR",
                      "description": "Three-letter IATA airport code used to determine the timezone of the airport location.  When used, the response includes an `airport_details` object containing airport metadata alongside the `time_zone` object.",
                      "disabled": true
                    },
                    {
                      "key": "long",
                      "value": "-74.006",
                      "description": "Longitude coordinate of the location used to determine the timezone. Must be provided together with the `lat` parameter.  Valid longitude values range from **-180 to 180**.",
                      "disabled": true
                    },
                    {
                      "key": "lat",
                      "value": "40.7128",
                      "description": "Latitude coordinate of the location used to determine the timezone. Must be provided together with the `long` parameter.  Valid latitude values range from **-90 to 90**.",
                      "disabled": true
                    },
                    {
                      "key": "location",
                      "value": "Lahore, Pakistan",
                      "description": "Address or location name used to determine the timezone.  Typically a city-level or region-level address such as `London, UK` or `New York, USA`.  When this parameter is used, the API returns a `location` object containing geolocation details alongside the `time_zone` object.",
                      "disabled": true
                    },
                    {
                      "key": "tz",
                      "value": "Australia/Lord_Howe",
                      "description": "IANA timezone identifier to retrieve timezone information.  When provided, the API returns the current date, time, and timezone metadata for the specified timezone.  If multiple lookup parameters are provided in the same request, the `tz` parameter takes the highest priority.  Example identifiers include `Europe/London`, `America/New_York`, and `Asia/Tokyo`.",
                      "disabled": true
                    }
                  ]
                }
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Credits-Charged",
                  "value": "1"
                }
              ],
              "body": "{\n  \"ip\": \"49.12.0.0\",\n  \"location\": {\n    \"continent_code\": \"EU\",\n    \"continent_name\": \"Europe\",\n    \"country_code2\": \"DE\",\n    \"country_code3\": \"DEU\",\n    \"country_name\": \"Germany\",\n    \"country_name_official\": \"Federal Republic of Germany\",\n    \"is_eu\": true,\n    \"state_prov\": \"Bavaria\",\n    \"state_code\": \"DE-BY\",\n    \"district\": \"Cham\",\n    \"city\": \"Falkenstein\",\n    \"zipcode\": \"93167\",\n    \"latitude\": \"49.09745\",\n    \"longitude\": \"12.48637\"\n  },\n  \"time_zone\": {\n    \"name\": \"Europe/Berlin\",\n    \"offset\": 1,\n    \"offset_with_dst\": 1,\n    \"date\": \"2026-03-07\",\n    \"date_time\": \"2026-03-07 10:37:39\",\n    \"date_time_txt\": \"Saturday, March 07, 2026 10:37:39\",\n    \"date_time_wti\": \"Sat, 07 Mar 2026 10:37:39 +0100\",\n    \"date_time_ymd\": \"2026-03-07T10:37:39+0100\",\n    \"current_time\": \"2026-03-07 10:37:39.744+0100\",\n    \"current_time_unix\": 1772876259.744,\n    \"time_24\": \"10:37:39\",\n    \"time_12\": \"10:37:39 AM\",\n    \"week\": 10,\n    \"month\": 3,\n    \"year\": 2026,\n    \"year_abbr\": \"26\",\n    \"current_tz_abbreviation\": \"CET\",\n    \"current_tz_full_name\": \"Central European Standard Time\",\n    \"standard_tz_abbreviation\": \"CET\",\n    \"standard_tz_full_name\": \"Central European Standard Time\",\n    \"is_dst\": false,\n    \"dst_savings\": 0,\n    \"dst_exists\": true,\n    \"dst_tz_abbreviation\": \"CEST\",\n    \"dst_tz_full_name\": \"Central European Summer Time\",\n    \"dst_start\": {\n      \"utc_time\": \"2026-03-29 TIME 01:00\",\n      \"duration\": \"+1.00H\",\n      \"gap\": true,\n      \"date_time_after\": \"2026-03-29 TIME 03:00\",\n      \"date_time_before\": \"2026-03-29 TIME 02:00\",\n      \"overlap\": false\n    },\n    \"dst_end\": {\n      \"utc_time\": \"2026-10-25 TIME 01:00\",\n      \"duration\": \"-1.00H\",\n      \"gap\": false,\n      \"date_time_after\": \"2026-10-25 TIME 02:00\",\n      \"date_time_before\": \"2026-10-25 TIME 03:00\",\n      \"overlap\": true\n    }\n  }\n}"
            },
            {
              "name": "400 Bad Request – Invalid IP or parameter",
              "originalRequest": {},
              "status": "Bad Request",
              "code": 400,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"message\": \"Provided name, service or IP address 'not_an_ip' is not valid.\"\n}"
            },
            {
              "name": "401 Unauthorized – Invalid or missing API key",
              "originalRequest": {},
              "status": "Unauthorized",
              "code": 401,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"message\": \"Provided API key is not valid. Contact technical support for assistance at support@ipgeolocation.io\"\n}"
            },
            {
              "name": "404 Not found– Not in our Database",
              "originalRequest": {},
              "status": "Not Found",
              "code": 404,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"message\": \"Provided IPv4 or IPv6 address does not exist in our database.\"\n}"
            },
            {
              "name": "405 Method Not Allowed – Post used on single endpoint",
              "originalRequest": {},
              "status": "Method Not Allowed",
              "code": 405,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"message\": \"Request method 'POST' is not supported\"\n}"
            },
            {
              "name": "423 Locked – Invalid IP range",
              "originalRequest": {},
              "status": "Locked",
              "code": 423,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"message\": \"'10.0.0.1' is a bogon IP address.\"\n}"
            },
            {
              "name": "429 Too Many Requests – Rate limit hit",
              "originalRequest": {},
              "status": "Too Many Requests",
              "code": 429,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"message\": \"You have exceeded the limit of PLAN_USAGE_LIMIT requests per PLAN_INERVAL for your subscribed PLAN plan. Please throttle your requests or upgrade your plan to continue using IPGeolocation API without interruption.\"\n}"
            },
            {
              "name": "499 Client Closed Request",
              "originalRequest": {},
              "status": "Client Closed Request",
              "code": 499,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"message\": \"Client closed the request before the server could respond.\"\n}"
            },
            {
              "name": "500 Internal Server Error",
              "originalRequest": {},
              "status": "Internal Server Error",
              "code": 500,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"message\": \"Something went wrong on the server side.\"\n}"
            }
          ]
        },
        {
          "name": "Timezone Time Conversion",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "https://api.ipgeolocation.io/v3/timezone/convert",
              "protocol": "https",
              "host": [
                "api",
                "ipgeolocation",
                "io"
              ],
              "path": [
                "v3",
                "timezone",
                "convert"
              ],
              "query": [
                {
                  "key": "tz_from",
                  "value": "America/New_York",
                  "description": "Source timezone identifier (IANA format) used for time conversion.",
                  "disabled": true
                },
                {
                  "key": "tz_to",
                  "value": "Asia/Kabul",
                  "description": "Destination timezone identifier (IANA format) used for time conversion.",
                  "disabled": true
                },
                {
                  "key": "time",
                  "value": "2025-01-30 09:00",
                  "description": "Date and time to convert.  Supported formats:  - `yyyy-MM-dd HH:mm` - `yyyy-MM-dd HH:mm:ss`  If omitted, the current time is used.",
                  "disabled": true
                },
                {
                  "key": "location_from",
                  "value": "New York, USA",
                  "description": "Source location address used to determine the source timezone.",
                  "disabled": true
                },
                {
                  "key": "location_to",
                  "value": "Lahore, Pakistan",
                  "description": "Destination location address used to determine the target timezone.",
                  "disabled": true
                },
                {
                  "key": "lat_from",
                  "value": "34.0207305",
                  "description": "",
                  "disabled": true
                },
                {
                  "key": "long_from",
                  "value": "-118.6919163",
                  "description": "",
                  "disabled": true
                },
                {
                  "key": "lat_to",
                  "value": "53.4736827",
                  "description": "",
                  "disabled": true
                },
                {
                  "key": "long_to",
                  "value": "-77.3977062",
                  "description": "",
                  "disabled": true
                },
                {
                  "key": "iata_from",
                  "value": "DXB",
                  "description": "",
                  "disabled": true
                },
                {
                  "key": "iata_to",
                  "value": "LHR",
                  "description": "",
                  "disabled": true
                },
                {
                  "key": "icao_from",
                  "value": "YSSY",
                  "description": "",
                  "disabled": true
                },
                {
                  "key": "icao_to",
                  "value": "ZBAA",
                  "description": "",
                  "disabled": true
                },
                {
                  "key": "locode_from",
                  "value": "PKISB",
                  "description": "",
                  "disabled": true
                },
                {
                  "key": "locode_to",
                  "value": "USNYC",
                  "description": "",
                  "disabled": true
                },
                {
                  "key": "output",
                  "value": "json",
                  "description": "Desired response format. Defaults to `json` if not specified. You can also control the format using the `Accept` header (`application/json`, `application/xml`, or `text/xml`). If both are provided, the `output` parameter takes precedence.  If `output` is unknown or unsupported, it is ignored and the response defaults to JSON (`application/json`) with HTTP 200. Supported values: `json`, `xml`. Defaults to `json`.",
                  "disabled": true
                }
              ]
            },
            "description": "Converts a given time between two timezones, locations,\ncoordinates, airports, or UN/LOCODE identifiers.\n\nThe conversion can be performed using one of the following\nparameter combinations:\n\n- `tz_from` and `tz_to`\n- `location_from` and `location_to`\n- `lat_from`, `long_from`, `lat_to`, `long_to`\n- `iata_from` and `iata_to`\n- `icao_from` and `icao_to`\n- `locode_from` and `locode_to`\n\nThe optional `time` parameter specifies the time to convert.\n\nSupported formats:\n\n- `yyyy-MM-dd HH:mm`\n- `yyyy-MM-dd HH:mm:ss`\n\nIf the `time` parameter is omitted, the current time is used\nfor conversion.\n\nEach successful conversion request consumes **1 credit**."
          },
          "response": [
            {
              "name": "200 OK – Success",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "https://api.ipgeolocation.io/v3/timezone/convert",
                  "protocol": "https",
                  "host": [
                    "api",
                    "ipgeolocation",
                    "io"
                  ],
                  "path": [
                    "v3",
                    "timezone",
                    "convert"
                  ],
                  "query": [
                    {
                      "key": "tz_from",
                      "value": "America/Argentina/Catamarca",
                      "description": "Source timezone identifier (IANA format) used for time conversion.",
                      "disabled": false
                    },
                    {
                      "key": "tz_to",
                      "value": "Asia/Kabul",
                      "description": "Destination timezone identifier (IANA format) used for time conversion.",
                      "disabled": false
                    },
                    {
                      "key": "time",
                      "value": "2024-12-08 11:00'",
                      "description": "Date and time to convert.  Supported formats:  - `yyyy-MM-dd HH:mm` - `yyyy-MM-dd HH:mm:ss`  If omitted, the current time is used.",
                      "disabled": false
                    },
                    {
                      "key": "location_from",
                      "value": "New York, USA",
                      "description": "Source location address used to determine the source timezone.",
                      "disabled": true
                    },
                    {
                      "key": "location_to",
                      "value": "Lahore, Pakistan",
                      "description": "Destination location address used to determine the target timezone.",
                      "disabled": true
                    },
                    {
                      "key": "lat_from",
                      "value": "34.0207305",
                      "description": "",
                      "disabled": true
                    },
                    {
                      "key": "long_from",
                      "value": "-118.6919163",
                      "description": "",
                      "disabled": true
                    },
                    {
                      "key": "lat_to",
                      "value": "53.4736827",
                      "description": "",
                      "disabled": true
                    },
                    {
                      "key": "long_to",
                      "value": "-77.3977062",
                      "description": "",
                      "disabled": true
                    },
                    {
                      "key": "iata_from",
                      "value": "DXB",
                      "description": "",
                      "disabled": true
                    },
                    {
                      "key": "iata_to",
                      "value": "LHR",
                      "description": "",
                      "disabled": true
                    },
                    {
                      "key": "icao_from",
                      "value": "YSSY",
                      "description": "",
                      "disabled": true
                    },
                    {
                      "key": "icao_to",
                      "value": "ZBAA",
                      "description": "",
                      "disabled": true
                    },
                    {
                      "key": "locode_from",
                      "value": "PKISB",
                      "description": "",
                      "disabled": true
                    },
                    {
                      "key": "locode_to",
                      "value": "USNYC",
                      "description": "",
                      "disabled": true
                    },
                    {
                      "key": "output",
                      "value": "json",
                      "description": "Desired response format. Defaults to `json` if not specified. You can also control the format using the `Accept` header (`application/json`, `application/xml`, or `text/xml`). If both are provided, the `output` parameter takes precedence.  If `output` is unknown or unsupported, it is ignored and the response defaults to JSON (`application/json`) with HTTP 200. Supported values: `json`, `xml`. Defaults to `json`.",
                      "disabled": true
                    }
                  ]
                }
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Credits-Charged",
                  "value": "1"
                }
              ],
              "body": "{\n  \"original_time\": \"2024-12-08 11:00\",\n  \"converted_time\": \"2024-12-08 18:30:00\",\n  \"diff_hour\": 7.5,\n  \"diff_min\": 450\n}"
            },
            {
              "name": "400 Bad Request – Invalid IP or parameter",
              "originalRequest": {},
              "status": "Bad Request",
              "code": 400,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"message\": \"Provided name, service or IP address 'not_an_ip' is not valid.\"\n}"
            },
            {
              "name": "401 Unauthorized – Invalid or missing API key",
              "originalRequest": {},
              "status": "Unauthorized",
              "code": 401,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"message\": \"Provided API key is not valid. Contact technical support for assistance at support@ipgeolocation.io\"\n}"
            },
            {
              "name": "404 Not found– Not in our Database",
              "originalRequest": {},
              "status": "Not Found",
              "code": 404,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"message\": \"Provided IPv4 or IPv6 address does not exist in our database.\"\n}"
            },
            {
              "name": "405 Method Not Allowed – Post used on single endpoint",
              "originalRequest": {},
              "status": "Method Not Allowed",
              "code": 405,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"message\": \"Request method 'POST' is not supported\"\n}"
            },
            {
              "name": "423 Locked – Invalid IP range",
              "originalRequest": {},
              "status": "Locked",
              "code": 423,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"message\": \"'10.0.0.1' is a bogon IP address.\"\n}"
            },
            {
              "name": "429 Too Many Requests – Rate limit hit",
              "originalRequest": {},
              "status": "Too Many Requests",
              "code": 429,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"message\": \"You have exceeded the limit of PLAN_USAGE_LIMIT requests per PLAN_INERVAL for your subscribed PLAN plan. Please throttle your requests or upgrade your plan to continue using IPGeolocation API without interruption.\"\n}"
            },
            {
              "name": "499 Client Closed Request",
              "originalRequest": {},
              "status": "Client Closed Request",
              "code": 499,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"message\": \"Client closed the request before the server could respond.\"\n}"
            },
            {
              "name": "500 Internal Server Error",
              "originalRequest": {},
              "status": "Internal Server Error",
              "code": 500,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"message\": \"Something went wrong on the server side.\"\n}"
            }
          ]
        }
      ]
    },
    {
      "name": "User-Agent API",
      "description": "API endpoints for parsing user agent strings into browser, device, layout engine,\nand operating system details. Supports single lookups via request header, custom\nstring lookups via JSON body, and bulk parsing of up to 50,000 strings per request.\nAlso detects bots, crawlers, and malicious or malformed user agent strings.",
      "item": [
        {
          "name": "Parse User Agent String (auto-detect or explicit header)",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "User-Agent",
                "value": "Mozilla/5.0 (Linux; Android 6.0.1; Nexus 5X Build/MMB29P) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/41.0.2272.96 Mobile Safari/537.36 (compatible; Googlebot/2.1; +http://www.google.com/bot.html)",
                "description": "The user agent string to parse. When omitted, the API automatically parses the user agent of the calling client. When provided, the supplied string is parsed instead."
              }
            ],
            "url": {
              "raw": "https://api.ipgeolocation.io/v3/user-agent",
              "protocol": "https",
              "host": [
                "api",
                "ipgeolocation",
                "io"
              ],
              "path": [
                "v3",
                "user-agent"
              ],
              "query": []
            },
            "description": "Parses a user agent string and returns browser, device, and operating system\ndetails. Also detects bots, crawlers, and malicious or malformed user agent strings.\n\nThis endpoint supports two usage modes:\n\n**Mode 1 — Auto-detect caller's user agent:**\nOmit the `User-Agent` header entirely. The API will parse the user agent string\nof the calling client automatically. This is the default browser behavior — when\nexecuted in browser JavaScript, the header is appended automatically and no\nadditional configuration is needed.\n\n**Mode 2 — Explicit user agent header:**\nPass any user agent string in the `User-Agent` request header. The API parses\nthat string instead of detecting the caller's own user agent. Use this to\nsimulate or test specific user agent strings server-side.\n\nEach successful lookup consumes **1 credit**."
          },
          "response": [
            {
              "name": "200 OK – Success",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json"
                  },
                  {
                    "key": "User-Agent",
                    "value": "Mozilla/5.0 (Linux; Android 6.0.1; Nexus 5X Build/MMB29P) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/41.0.2272.96 Mobile Safari/537.36 (compatible; Googlebot/2.1; +http://www.google.com/bot.html)",
                    "description": "The user agent string to parse. When omitted, the API automatically parses the user agent of the calling client. When provided, the supplied string is parsed instead."
                  }
                ],
                "url": {
                  "raw": "https://api.ipgeolocation.io/v3/user-agent",
                  "protocol": "https",
                  "host": [
                    "api",
                    "ipgeolocation",
                    "io"
                  ],
                  "path": [
                    "v3",
                    "user-agent"
                  ],
                  "query": []
                }
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Credits-Charged",
                  "value": "1"
                }
              ],
              "body": "{\n  \"user_agent_string\": \"Mozilla/5.0 (Macintosh; Intel Mac OS X 10_11_2) AppleWebKit/601.3.9 (KHTML, like Gecko) Version/9.0.2 Safari/601.3.9\",\n  \"name\": \"Safari\",\n  \"type\": \"Browser\",\n  \"version\": \"9.0.2\",\n  \"version_major\": \"9\",\n  \"device\": {\n    \"name\": \"Apple Macintosh\",\n    \"type\": \"Desktop\",\n    \"brand\": \"Apple\",\n    \"cpu\": \"Intel\"\n  },\n  \"engine\": {\n    \"name\": \"AppleWebKit\",\n    \"type\": \"Browser\",\n    \"version\": \"601.3.9\",\n    \"version_major\": \"601\"\n  },\n  \"operating_system\": {\n    \"name\": \"Mac OS\",\n    \"type\": \"Desktop\",\n    \"version\": \"10.11.2\",\n    \"version_major\": \"10.11\",\n    \"build\": \"??\"\n  }\n}"
            },
            {
              "name": "400 Bad Request – Invalid IP or parameter",
              "originalRequest": {},
              "status": "Bad Request",
              "code": 400,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"message\": \"Provided name, service or IP address 'not_an_ip' is not valid.\"\n}"
            },
            {
              "name": "401 Unauthorized – Invalid or missing API key",
              "originalRequest": {},
              "status": "Unauthorized",
              "code": 401,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"message\": \"Provided API key is not valid. Contact technical support for assistance at support@ipgeolocation.io\"\n}"
            },
            {
              "name": "404 Not found– Not in our Database",
              "originalRequest": {},
              "status": "Not Found",
              "code": 404,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"message\": \"Provided IPv4 or IPv6 address does not exist in our database.\"\n}"
            },
            {
              "name": "405 Method Not Allowed – Post used on single endpoint",
              "originalRequest": {},
              "status": "Method Not Allowed",
              "code": 405,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"message\": \"Request method 'POST' is not supported\"\n}"
            },
            {
              "name": "429 Too Many Requests – Rate limit hit",
              "originalRequest": {},
              "status": "Too Many Requests",
              "code": 429,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"message\": \"You have exceeded the limit of PLAN_USAGE_LIMIT requests per PLAN_INERVAL for your subscribed PLAN plan. Please throttle your requests or upgrade your plan to continue using IPGeolocation API without interruption.\"\n}"
            },
            {
              "name": "499 Client Closed Request",
              "originalRequest": {},
              "status": "Client Closed Request",
              "code": 499,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"message\": \"Client closed the request before the server could respond.\"\n}"
            },
            {
              "name": "500 Internal Server Error",
              "originalRequest": {},
              "status": "Internal Server Error",
              "code": 500,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"message\": \"Something went wrong on the server side.\"\n}"
            }
          ]
        },
        {
          "name": "Parse Custom User Agent String (payload)",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "https://api.ipgeolocation.io/v3/user-agent",
              "protocol": "https",
              "host": [
                "api",
                "ipgeolocation",
                "io"
              ],
              "path": [
                "v3",
                "user-agent"
              ],
              "query": []
            },
            "description": "Parses a custom user agent string supplied in the JSON request body and returns\nbrowser, device, and operating system details.\n\n**Mode 3 — Custom user agent string via POST body:**\nPass the user agent string as the `uaString` field in a JSON payload. This is\nintended for server-side use cases where the string to be parsed is different\nfrom the caller's own user agent and is known at request time.\n\nThis endpoint is available on **paid plans only**.\n\nEach successful lookup consumes **1 credit**.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"uaString\": \"Mozilla/5.0 (Macintosh; Intel Mac OS X 10_11_2) AppleWebKit/601.3.9 (KHTML, like Gecko) Version/9.0.2 Safari/601.3.9\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": [
            {
              "name": "200 OK – Success",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "https://api.ipgeolocation.io/v3/user-agent",
                  "protocol": "https",
                  "host": [
                    "api",
                    "ipgeolocation",
                    "io"
                  ],
                  "path": [
                    "v3",
                    "user-agent"
                  ],
                  "query": []
                },
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"uaString\": \"Mozilla/5.0 (Macintosh; Intel Mac OS X 10_11_2) AppleWebKit/601.3.9 (KHTML, like Gecko) Version/9.0.2 Safari/601.3.9\"\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Credits-Charged",
                  "value": "1"
                }
              ],
              "body": "{\n  \"user_agent_string\": \"Mozilla/5.0 (Macintosh; Intel Mac OS X 10_11_2) AppleWebKit/601.3.9 (KHTML, like Gecko) Version/9.0.2 Safari/601.3.9\",\n  \"name\": \"Safari\",\n  \"type\": \"Browser\",\n  \"version\": \"9.0.2\",\n  \"version_major\": \"9\",\n  \"device\": {\n    \"name\": \"Apple Macintosh\",\n    \"type\": \"Desktop\",\n    \"brand\": \"Apple\",\n    \"cpu\": \"Intel\"\n  },\n  \"engine\": {\n    \"name\": \"AppleWebKit\",\n    \"type\": \"Browser\",\n    \"version\": \"601.3.9\",\n    \"version_major\": \"601\"\n  },\n  \"operating_system\": {\n    \"name\": \"Mac OS\",\n    \"type\": \"Desktop\",\n    \"version\": \"10.11.2\",\n    \"version_major\": \"10.11\",\n    \"build\": \"??\"\n  }\n}"
            },
            {
              "name": "400 Bad Request – Invalid IP or parameter",
              "originalRequest": {},
              "status": "Bad Request",
              "code": 400,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"message\": \"Provided name, service or IP address 'not_an_ip' is not valid.\"\n}"
            },
            {
              "name": "401 Unauthorized – Invalid or missing API key",
              "originalRequest": {},
              "status": "Unauthorized",
              "code": 401,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"message\": \"Provided API key is not valid. Contact technical support for assistance at support@ipgeolocation.io\"\n}"
            },
            {
              "name": "401 Unauthorized – Free plan restriction",
              "originalRequest": {},
              "status": "Unauthorized",
              "code": 401,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"message\": \"Custom User-Agent lookup is not supported on your current subscription. This feature is available to all paid subscriptions only.\"\n}"
            },
            {
              "name": "404 Not found– Not in our Database",
              "originalRequest": {},
              "status": "Not Found",
              "code": 404,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"message\": \"Provided IPv4 or IPv6 address does not exist in our database.\"\n}"
            },
            {
              "name": "405 Method Not Allowed – Post used on single endpoint",
              "originalRequest": {},
              "status": "Method Not Allowed",
              "code": 405,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"message\": \"Request method 'POST' is not supported\"\n}"
            },
            {
              "name": "429 Too Many Requests – Rate limit hit",
              "originalRequest": {},
              "status": "Too Many Requests",
              "code": 429,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"message\": \"You have exceeded the limit of PLAN_USAGE_LIMIT requests per PLAN_INERVAL for your subscribed PLAN plan. Please throttle your requests or upgrade your plan to continue using IPGeolocation API without interruption.\"\n}"
            },
            {
              "name": "499 Client Closed Request",
              "originalRequest": {},
              "status": "Client Closed Request",
              "code": 499,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"message\": \"Client closed the request before the server could respond.\"\n}"
            },
            {
              "name": "500 Internal Server Error",
              "originalRequest": {},
              "status": "Internal Server Error",
              "code": 500,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"message\": \"Something went wrong on the server side.\"\n}"
            }
          ]
        },
        {
          "name": "Bulk Parse User Agent Strings",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "https://api.ipgeolocation.io/v3/user-agent-bulk",
              "protocol": "https",
              "host": [
                "api",
                "ipgeolocation",
                "io"
              ],
              "path": [
                "v3",
                "user-agent-bulk"
              ],
              "query": []
            },
            "description": "Parses up to **50,000 user agent strings** in a single request.\n\nPass a JSON body containing the `uaStrings` array. Each entry in the array\nis parsed independently. The total credits charged equals the number of strings\nin the array.\n\nThis endpoint is available on **paid plans only**.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"uaStrings\": [\n   \"Mozilla/5.0 (Macintosh; Intel Mac OS X 10_11_2) AppleWebKit/601.3.9 (KHTML, like Gecko) Version/9.0.2 Safari/601.3.9\",\n    \"Mozilla/5.0 (X11; U; Linux armv7l like Android; en-us) AppleWebKit/531.2+ (KHTML, like Gecko) Version/5.0 Safari/533.2+ Kindle/3.0+\"\n  ]\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": [
            {
              "name": "200 OK – Success",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "https://api.ipgeolocation.io/v3/user-agent-bulk",
                  "protocol": "https",
                  "host": [
                    "api",
                    "ipgeolocation",
                    "io"
                  ],
                  "path": [
                    "v3",
                    "user-agent-bulk"
                  ],
                  "query": []
                },
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"uaStrings\": [\n   \"Mozilla/5.0 (Macintosh; Intel Mac OS X 10_11_2) AppleWebKit/601.3.9 (KHTML, like Gecko) Version/9.0.2 Safari/601.3.9\",\n    \"Mozilla/5.0 (X11; U; Linux armv7l like Android; en-us) AppleWebKit/531.2+ (KHTML, like Gecko) Version/5.0 Safari/533.2+ Kindle/3.0+\"\n  ]\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Credits-Charged",
                  "value": "1"
                }
              ],
              "body": "[\n  {\n    \"user_agent_string\": \"Mozilla/5.0 (Linux; Android 8.0.0; SM-G960F Build/R16NW) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/62.0.3202.84 Mobile Safari/537.36\",\n    \"name\": \"Chrome\",\n    \"type\": \"Browser\",\n    \"version\": \"62.0.3202.84\",\n    \"version_major\": \"62\",\n    \"device\": {\n      \"name\": \"Samsung SM-G960F\",\n      \"type\": \"Phone\",\n      \"brand\": \"Samsung\",\n      \"cpu\": \"Unknown\"\n    },\n    \"engine\": {\n      \"name\": \"Blink\",\n      \"type\": \"Browser\",\n      \"version\": \"62.0\",\n      \"version_major\": \"62\"\n    },\n    \"operating_system\": {\n      \"name\": \"Android\",\n      \"type\": \"Mobile\",\n      \"version\": \"8.0.0\",\n      \"version_major\": \"8\",\n      \"build\": \"R16NW\"\n    }\n  },\n  {\n    \"user_agent_string\": \"Mozilla/5.0 (X11; U; Linux armv7l like Android; en-us) AppleWebKit/531.2+ (KHTML, like Gecko) Version/5.0 Safari/533.2+ Kindle/3.0+\",\n    \"name\": \"Kindle\",\n    \"type\": \"Browser\",\n    \"version\": \"3.0\",\n    \"version_major\": \"3\",\n    \"device\": {\n      \"name\": \"Amazon Kindle\",\n      \"type\": \"eReader\",\n      \"brand\": \"Amazon\",\n      \"cpu\": \"ARMv7l\"\n    },\n    \"engine\": {\n      \"name\": \"AppleWebKit\",\n      \"type\": \"Browser\",\n      \"version\": \"531.2\",\n      \"version_major\": \"531\"\n    },\n    \"operating_system\": {\n      \"name\": \"FireOS\",\n      \"type\": \"Mobile\",\n      \"version\": \"??\",\n      \"version_major\": \"??\",\n      \"build\": \"??\"\n    }\n  }\n]"
            },
            {
              "name": "400 Bad Request – Invalid IP or parameter",
              "originalRequest": {},
              "status": "Bad Request",
              "code": 400,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"message\": \"Provided name, service or IP address 'not_an_ip' is not valid.\"\n}"
            },
            {
              "name": "401 Unauthorized – Invalid or missing API key",
              "originalRequest": {},
              "status": "Unauthorized",
              "code": 401,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"message\": \"Provided API key is not valid. Contact technical support for assistance at support@ipgeolocation.io\"\n}"
            },
            {
              "name": "401 Unauthorized – Free plan restriction",
              "originalRequest": {},
              "status": "Unauthorized",
              "code": 401,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"message\": \"Custom User-Agent lookup is not supported on your current subscription. This feature is available to all paid subscriptions only.\"\n}"
            },
            {
              "name": "404 Not found– Not in our Database",
              "originalRequest": {},
              "status": "Not Found",
              "code": 404,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"message\": \"Provided IPv4 or IPv6 address does not exist in our database.\"\n}"
            },
            {
              "name": "405 Method Not Allowed – Post used on single endpoint",
              "originalRequest": {},
              "status": "Method Not Allowed",
              "code": 405,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"message\": \"Request method 'GET' is not supported\"\n}"
            },
            {
              "name": "429 Too Many Requests – Rate limit hit",
              "originalRequest": {},
              "status": "Too Many Requests",
              "code": 429,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"message\": \"You have exceeded the limit of PLAN_USAGE_LIMIT requests per PLAN_INERVAL for your subscribed PLAN plan. Please throttle your requests or upgrade your plan to continue using IPGeolocation API without interruption.\"\n}"
            },
            {
              "name": "499 Client Closed Request",
              "originalRequest": {},
              "status": "Client Closed Request",
              "code": 499,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"message\": \"Client closed the request before the server could respond.\"\n}"
            },
            {
              "name": "500 Internal Server Error",
              "originalRequest": {},
              "status": "Internal Server Error",
              "code": 500,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"message\": \"Something went wrong on the server side.\"\n}"
            }
          ]
        }
      ]
    },
    {
      "name": "Astronomy API",
      "description": "API endpoints for retrieving astronomical information for a given\nlocation, including sunrise and sunset times, moonrise and moonset\ntimes, twilight phases, golden hour and blue hour windows, solar noon,\nsun and moon position data (altitude, azimuth, distance), and moon\nphase.\n\nA time series endpoint is also available to retrieve daily astronomical\ndata across a date range of up to 90 days.",
      "item": [
        {
          "name": "Astronomy Lookup",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "https://api.ipgeolocation.io/v3/astronomy",
              "protocol": "https",
              "host": [
                "api",
                "ipgeolocation",
                "io"
              ],
              "path": [
                "v3",
                "astronomy"
              ],
              "query": [
                {
                  "key": "lat",
                  "value": "-27.4748",
                  "description": "Latitude coordinate of the location. Must be provided together with the `long` parameter.  Valid latitude values range from **-90 to 90**.",
                  "disabled": true
                },
                {
                  "key": "long",
                  "value": "153.017",
                  "description": "Longitude coordinate of the location. Must be provided together with the `lat` parameter.  Valid longitude values range from **-180 to 180**.",
                  "disabled": true
                },
                {
                  "key": "location",
                  "value": "London, UK",
                  "description": "Address or location name used to determine the astronomical information. Typically a city-level or region-level address such as `New York, USA` or `London, UK`.  When this parameter is used, the API returns a `location` object containing geolocation details alongside the `astronomy` object.",
                  "disabled": true
                },
                {
                  "key": "ip",
                  "value": "2607:fb91:16c6:8860:e531:2d1d:4944:6c7c",
                  "description": "An IPv4 or IPv6 address used to resolve the location for the astronomical lookup. When omitted, the API resolves the public IP of the requesting client.  When the lookup is performed using an IP address, the response includes additional geolocation fields in the `location` object such as continent, country codes, district, and zipcode.",
                  "disabled": true
                },
                {
                  "key": "date",
                  "value": "2026-03-18",
                  "description": "Date for which to retrieve astronomical information.  Must be in `yyyy-MM-dd` format. Defaults to the current date if not provided. All astronomical information is calculated at the current time of day at the resolved location.",
                  "disabled": true
                },
                {
                  "key": "elevation",
                  "value": "1500",
                  "description": "Elevation of the location above sea level in meters. Used to refine astronomical calculations.  Defaults to `0` if not provided. Maximum allowed value is **10,000 meters**. Negative values are treated as `0`.",
                  "disabled": true
                },
                {
                  "key": "time_zone",
                  "value": "America/New_York",
                  "description": "IANA timezone identifier used to convert all astronomical event timestamps into the specified timezone.  When provided, all event times (sunrise, sunset, moonrise, moonset, twilight phases, solar noon, etc.) are returned as full date-time values (`yyyy-MM-dd HH:mm`) instead of time-only values (`HH:mm`), and a `time_zone` field is included in the `astronomy` object.  The geographic location used for astronomical calculations remains unchanged. Only the timestamp representation is converted.  Example: `Europe/London`, `America/New_York`, `Asia/Karachi`.",
                  "disabled": true
                },
                {
                  "key": "lang",
                  "value": "en",
                  "description": "Language code for translated location names in the `location` object. Only applies when the lookup is performed via an IP address.  Defaults to `en`. Non-English responses require a paid plan. Free plans always receive English regardless of this parameter. Unsupported `lang` values return HTTP 400. Language code. Supported values: `en`, `de`, `ru`, `ja`, `fr`, `cn`, `es`, `cs`, `it`, `ko`, `fa`, `pt`. Defaults to `en`.",
                  "disabled": true
                }
              ]
            },
            "description": "Returns astronomical information for a specific location and date,\nincluding:\n\n- Sunrise and sunset times\n- Moonrise and moonset times\n- Morning and evening twilight phases (astronomical, nautical, civil)\n- Golden hour and blue hour windows (morning and evening)\n- Solar noon, day length, and astronomical midnight\n- Sun position: altitude, azimuth, distance from Earth\n- Moon position: altitude, azimuth, distance from Earth, parallactic angle\n- Moon phase, illumination percentage, and angular diameter\n\nThe location can be resolved using geographic coordinates (`lat` and\n`long`), a location address (`location`), or an IP address (`ip`).\n\nIf multiple lookup parameters are provided, the API resolves the\nlocation using the following priority order:\n\n1. `lat` and `long`\n2. `location`\n3. `ip`\n\nIf none of the lookup parameters are provided, the API resolves the\nlocation using the public IP address of the requesting client.\n\nBy default, results are calculated for the current date. Pass the\n`date` parameter to retrieve data for a specific date.\n\nEach successful lookup consumes **1 credit**."
          },
          "response": [
            {
              "name": "200 OK – Success",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "https://api.ipgeolocation.io/v3/astronomy",
                  "protocol": "https",
                  "host": [
                    "api",
                    "ipgeolocation",
                    "io"
                  ],
                  "path": [
                    "v3",
                    "astronomy"
                  ],
                  "query": [
                    {
                      "key": "lat",
                      "value": "40.76473",
                      "description": "Latitude coordinate of the location. Must be provided together with the `long` parameter.  Valid latitude values range from **-90 to 90**.",
                      "disabled": false
                    },
                    {
                      "key": "long",
                      "value": "-74.00084",
                      "description": "Longitude coordinate of the location. Must be provided together with the `lat` parameter.  Valid longitude values range from **-180 to 180**.",
                      "disabled": false
                    },
                    {
                      "key": "location",
                      "value": "London, UK",
                      "description": "Address or location name used to determine the astronomical information. Typically a city-level or region-level address such as `New York, USA` or `London, UK`.  When this parameter is used, the API returns a `location` object containing geolocation details alongside the `astronomy` object.",
                      "disabled": true
                    },
                    {
                      "key": "ip",
                      "value": "2607:fb91:16c6:8860:e531:2d1d:4944:6c7c",
                      "description": "An IPv4 or IPv6 address used to resolve the location for the astronomical lookup. When omitted, the API resolves the public IP of the requesting client.  When the lookup is performed using an IP address, the response includes additional geolocation fields in the `location` object such as continent, country codes, district, and zipcode.",
                      "disabled": true
                    },
                    {
                      "key": "date",
                      "value": "2026-03-18",
                      "description": "Date for which to retrieve astronomical information.  Must be in `yyyy-MM-dd` format. Defaults to the current date if not provided. All astronomical information is calculated at the current time of day at the resolved location.",
                      "disabled": true
                    },
                    {
                      "key": "elevation",
                      "value": "9",
                      "description": "Elevation of the location above sea level in meters. Used to refine astronomical calculations.  Defaults to `0` if not provided. Maximum allowed value is **10,000 meters**. Negative values are treated as `0`.",
                      "disabled": false
                    },
                    {
                      "key": "time_zone",
                      "value": "America/New_York",
                      "description": "IANA timezone identifier used to convert all astronomical event timestamps into the specified timezone.  When provided, all event times (sunrise, sunset, moonrise, moonset, twilight phases, solar noon, etc.) are returned as full date-time values (`yyyy-MM-dd HH:mm`) instead of time-only values (`HH:mm`), and a `time_zone` field is included in the `astronomy` object.  The geographic location used for astronomical calculations remains unchanged. Only the timestamp representation is converted.  Example: `Europe/London`, `America/New_York`, `Asia/Karachi`.",
                      "disabled": true
                    },
                    {
                      "key": "lang",
                      "value": "en",
                      "description": "Language code for translated location names in the `location` object. Only applies when the lookup is performed via an IP address.  Defaults to `en`. Non-English responses require a paid plan. Free plans always receive English regardless of this parameter. Unsupported `lang` values return HTTP 400. Language code. Supported values: `en`, `de`, `ru`, `ja`, `fr`, `cn`, `es`, `cs`, `it`, `ko`, `fa`, `pt`. Defaults to `en`.",
                      "disabled": true
                    }
                  ]
                }
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Credits-Charged",
                  "value": "1"
                }
              ],
              "body": "{\n  \"location\": {\n    \"latitude\": \"40.76473\",\n    \"longitude\": \"-74.00084\",\n    \"country_name\": \"United States\",\n    \"state_prov\": \"New York\",\n    \"city\": \"New York\",\n    \"locality\": \"Midtown West\",\n    \"elevation\": \"9\"\n  },\n  \"astronomy\": {\n    \"date\": \"2026-03-18\",\n    \"current_time\": \"10:15:00.000\",\n    \"mid_night\": \"00:06\",\n    \"night_end\": \"04:49\",\n    \"morning\": {\n      \"astronomical_twilight_begin\": \"04:49\",\n      \"astronomical_twilight_end\": \"05:21\",\n      \"nautical_twilight_begin\": \"05:21\",\n      \"nautical_twilight_end\": \"05:53\",\n      \"civil_twilight_begin\": \"05:53\",\n      \"civil_twilight_end\": \"06:20\",\n      \"blue_hour_begin\": \"05:42\",\n      \"blue_hour_end\": \"06:03\",\n      \"golden_hour_begin\": \"06:03\",\n      \"golden_hour_end\": \"06:57\"\n    },\n    \"sunrise\": \"06:20\",\n    \"sunset\": \"19:00\",\n    \"evening\": {\n      \"golden_hour_begin\": \"18:23\",\n      \"golden_hour_end\": \"19:16\",\n      \"blue_hour_begin\": \"19:16\",\n      \"blue_hour_end\": \"19:38\",\n      \"civil_twilight_begin\": \"19:00\",\n      \"civil_twilight_end\": \"19:27\",\n      \"nautical_twilight_begin\": \"19:27\",\n      \"nautical_twilight_end\": \"19:59\",\n      \"astronomical_twilight_begin\": \"19:59\",\n      \"astronomical_twilight_end\": \"20:31\"\n    },\n    \"night_begin\": \"20:31\",\n    \"sun_status\": \"-\",\n    \"solar_noon\": \"12:40\",\n    \"day_length\": \"12:40\",\n    \"sun_altitude\": 42.5,\n    \"sun_distance\": 148900000.0,\n    \"sun_azimuth\": 150.3,\n    \"moon_phase\": \"WAXING_CRESCENT\",\n    \"moonrise\": \"08:45\",\n    \"moonset\": \"22:10\",\n    \"moon_status\": \"-\",\n    \"moon_altitude\": 15.2,\n    \"moon_distance\": 384400.0,\n    \"moon_azimuth\": 220.5,\n    \"moon_parallactic_angle\": 30.1,\n    \"moon_illumination_percentage\": \"25.40\",\n    \"moon_angle\": 0.52\n  }\n}"
            },
            {
              "name": "400 Bad Request – Invalid IP or parameter",
              "originalRequest": {},
              "status": "Bad Request",
              "code": 400,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"message\": \"Provided name, service or IP address 'not_an_ip' is not valid.\"\n}"
            },
            {
              "name": "401 Unauthorized – Invalid or missing API key",
              "originalRequest": {},
              "status": "Unauthorized",
              "code": 401,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"message\": \"Provided API key is not valid. Contact technical support for assistance at support@ipgeolocation.io\"\n}"
            },
            {
              "name": "404 Not found– Not in our Database",
              "originalRequest": {},
              "status": "Not Found",
              "code": 404,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"message\": \"Provided IPv4 or IPv6 address does not exist in our database.\"\n}"
            },
            {
              "name": "405 Method Not Allowed – Post used on single endpoint",
              "originalRequest": {},
              "status": "Method Not Allowed",
              "code": 405,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"message\": \"Request method 'POST' is not supported\"\n}"
            },
            {
              "name": "423 Locked – Invalid IP range",
              "originalRequest": {},
              "status": "Locked",
              "code": 423,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"message\": \"'10.0.0.1' is a bogon IP address.\"\n}"
            },
            {
              "name": "429 Too Many Requests – Rate limit hit",
              "originalRequest": {},
              "status": "Too Many Requests",
              "code": 429,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"message\": \"You have exceeded the limit of PLAN_USAGE_LIMIT requests per PLAN_INERVAL for your subscribed PLAN plan. Please throttle your requests or upgrade your plan to continue using IPGeolocation API without interruption.\"\n}"
            },
            {
              "name": "499 Client Closed Request",
              "originalRequest": {},
              "status": "Client Closed Request",
              "code": 499,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"message\": \"Client closed the request before the server could respond.\"\n}"
            },
            {
              "name": "500 Internal Server Error",
              "originalRequest": {},
              "status": "Internal Server Error",
              "code": 500,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"message\": \"Something went wrong on the server side.\"\n}"
            }
          ]
        },
        {
          "name": "Astronomy Time Series Lookup",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "https://api.ipgeolocation.io/v3/astronomy/timeSeries",
              "protocol": "https",
              "host": [
                "api",
                "ipgeolocation",
                "io"
              ],
              "path": [
                "v3",
                "astronomy",
                "timeSeries"
              ],
              "query": [
                {
                  "key": "lat",
                  "value": "-27.4748",
                  "description": "Latitude coordinate of the location. Must be provided together with the `long` parameter.  Valid latitude values range from **-90 to 90**.",
                  "disabled": true
                },
                {
                  "key": "long",
                  "value": "153.017",
                  "description": "Longitude coordinate of the location. Must be provided together with the `lat` parameter.  Valid longitude values range from **-180 to 180**.",
                  "disabled": true
                },
                {
                  "key": "location",
                  "value": "London, UK",
                  "description": "Address or location name used to determine the astronomical information. Typically a city-level or region-level address such as `New York, USA` or `London, UK`.  When this parameter is used, the API returns a `location` object containing geolocation details alongside the `astronomy` object.",
                  "disabled": true
                },
                {
                  "key": "ip",
                  "value": "2607:fb91:16c6:8860:e531:2d1d:4944:6c7c",
                  "description": "An IPv4 or IPv6 address used to resolve the location for the astronomical lookup. When omitted, the API resolves the public IP of the requesting client.  When the lookup is performed using an IP address, the response includes additional geolocation fields in the `location` object such as continent, country codes, district, and zipcode.",
                  "disabled": true
                },
                {
                  "key": "dateStart",
                  "value": "2026-03-18",
                  "description": "Start date of the time series range.  Must be in `yyyy-MM-dd` format. The maximum allowed span between `dateStart` and `dateEnd` is **90 days**.",
                  "disabled": false
                },
                {
                  "key": "dateEnd",
                  "value": "2026-04-18",
                  "description": "End date of the time series range.  Must be in `yyyy-MM-dd` format. The maximum allowed span between `dateStart` and `dateEnd` is **90 days**.",
                  "disabled": false
                },
                {
                  "key": "elevation",
                  "value": "1500",
                  "description": "Elevation of the location above sea level in meters. Used to refine astronomical calculations.  Defaults to `0` if not provided. Maximum allowed value is **10,000 meters**. Negative values are treated as `0`.",
                  "disabled": true
                },
                {
                  "key": "time_zone",
                  "value": "America/New_York",
                  "description": "IANA timezone identifier used to convert all astronomical event timestamps into the specified timezone.  When provided, all event times (sunrise, sunset, moonrise, moonset, twilight phases, solar noon, etc.) are returned as full date-time values (`yyyy-MM-dd HH:mm`) instead of time-only values (`HH:mm`), and a `time_zone` field is included in the `astronomy` object.  The geographic location used for astronomical calculations remains unchanged. Only the timestamp representation is converted.  Example: `Europe/London`, `America/New_York`, `Asia/Karachi`.",
                  "disabled": true
                },
                {
                  "key": "lang",
                  "value": "en",
                  "description": "Language code for translated location names in the `location` object. Only applies when the lookup is performed via an IP address.  Defaults to `en`. Non-English responses require a paid plan. Free plans always receive English regardless of this parameter. Unsupported `lang` values return HTTP 400. Language code. Supported values: `en`, `de`, `ru`, `ja`, `fr`, `cn`, `es`, `cs`, `it`, `ko`, `fa`, `pt`. Defaults to `en`.",
                  "disabled": true
                }
              ]
            },
            "description": "Returns daily astronomical information for a specific location across\na date range.\n\nThe response contains an array of daily astronomy records, each\nincluding sunrise, sunset, moonrise, moonset, twilight phases,\nsolar noon, day length, and moon phase. Real-time positional data\n(altitude, azimuth, distance) is not included in time series\nresponses.\n\nThe location can be resolved using geographic coordinates (`lat` and\n`long`), a location address (`location`), or an IP address (`ip`).\n\n**Date range constraints:**\n- Both `dateStart` and `dateEnd` are required.\n- The maximum allowed span between `dateStart` and `dateEnd` is\n  **90 days**.\n- Both past and future dates are supported within the 90-day window.\n\nEach successful lookup consumes **1 credit** per request."
          },
          "response": [
            {
              "name": "200 OK – Success",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "https://api.ipgeolocation.io/v3/astronomy/timeSeries",
                  "protocol": "https",
                  "host": [
                    "api",
                    "ipgeolocation",
                    "io"
                  ],
                  "path": [
                    "v3",
                    "astronomy",
                    "timeSeries"
                  ],
                  "query": [
                    {
                      "key": "lat",
                      "value": "40.76473",
                      "description": "Latitude coordinate of the location. Must be provided together with the `long` parameter.  Valid latitude values range from **-90 to 90**.",
                      "disabled": false
                    },
                    {
                      "key": "long",
                      "value": "-74.00084",
                      "description": "Longitude coordinate of the location. Must be provided together with the `lat` parameter.  Valid longitude values range from **-180 to 180**.",
                      "disabled": false
                    },
                    {
                      "key": "location",
                      "value": "London, UK",
                      "description": "Address or location name used to determine the astronomical information. Typically a city-level or region-level address such as `New York, USA` or `London, UK`.  When this parameter is used, the API returns a `location` object containing geolocation details alongside the `astronomy` object.",
                      "disabled": true
                    },
                    {
                      "key": "ip",
                      "value": "2607:fb91:16c6:8860:e531:2d1d:4944:6c7c",
                      "description": "An IPv4 or IPv6 address used to resolve the location for the astronomical lookup. When omitted, the API resolves the public IP of the requesting client.  When the lookup is performed using an IP address, the response includes additional geolocation fields in the `location` object such as continent, country codes, district, and zipcode.",
                      "disabled": true
                    },
                    {
                      "key": "dateStart",
                      "value": "2025-06-16",
                      "description": "Start date of the time series range.  Must be in `yyyy-MM-dd` format. The maximum allowed span between `dateStart` and `dateEnd` is **90 days**.",
                      "disabled": false
                    },
                    {
                      "key": "dateEnd",
                      "value": "2025-06-18",
                      "description": "End date of the time series range.  Must be in `yyyy-MM-dd` format. The maximum allowed span between `dateStart` and `dateEnd` is **90 days**.",
                      "disabled": false
                    },
                    {
                      "key": "elevation",
                      "value": "1500",
                      "description": "Elevation of the location above sea level in meters. Used to refine astronomical calculations.  Defaults to `0` if not provided. Maximum allowed value is **10,000 meters**. Negative values are treated as `0`.",
                      "disabled": true
                    },
                    {
                      "key": "time_zone",
                      "value": "America/New_York",
                      "description": "IANA timezone identifier used to convert all astronomical event timestamps into the specified timezone.  When provided, all event times (sunrise, sunset, moonrise, moonset, twilight phases, solar noon, etc.) are returned as full date-time values (`yyyy-MM-dd HH:mm`) instead of time-only values (`HH:mm`), and a `time_zone` field is included in the `astronomy` object.  The geographic location used for astronomical calculations remains unchanged. Only the timestamp representation is converted.  Example: `Europe/London`, `America/New_York`, `Asia/Karachi`.",
                      "disabled": true
                    },
                    {
                      "key": "lang",
                      "value": "en",
                      "description": "Language code for translated location names in the `location` object. Only applies when the lookup is performed via an IP address.  Defaults to `en`. Non-English responses require a paid plan. Free plans always receive English regardless of this parameter. Unsupported `lang` values return HTTP 400. Language code. Supported values: `en`, `de`, `ru`, `ja`, `fr`, `cn`, `es`, `cs`, `it`, `ko`, `fa`, `pt`. Defaults to `en`.",
                      "disabled": true
                    }
                  ]
                }
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Credits-Charged",
                  "value": "1"
                }
              ],
              "body": "{\n  \"location\": {\n    \"latitude\": \"40.76473\",\n    \"longitude\": \"-74.00084\",\n    \"country_name\": \"United States\",\n    \"state_prov\": \"New York\",\n    \"city\": \"New York\",\n    \"locality\": \"Midtown West\",\n    \"elevation\": \"9\"\n  },\n  \"astronomy\": [\n    {\n      \"date\": \"2026-03-18\",\n      \"mid_night\": \"00:06\",\n      \"night_end\": \"04:49\",\n      \"morning\": {\n        \"astronomical_twilight_begin\": \"04:49\",\n        \"astronomical_twilight_end\": \"05:21\",\n        \"nautical_twilight_begin\": \"05:21\",\n        \"nautical_twilight_end\": \"05:53\",\n        \"civil_twilight_begin\": \"05:53\",\n        \"civil_twilight_end\": \"06:20\",\n        \"blue_hour_begin\": \"05:42\",\n        \"blue_hour_end\": \"06:03\",\n        \"golden_hour_begin\": \"06:03\",\n        \"golden_hour_end\": \"06:57\"\n      },\n      \"sunrise\": \"06:20\",\n      \"sunset\": \"19:00\",\n      \"evening\": {\n        \"golden_hour_begin\": \"18:23\",\n        \"golden_hour_end\": \"19:16\",\n        \"blue_hour_begin\": \"19:16\",\n        \"blue_hour_end\": \"19:38\",\n        \"civil_twilight_begin\": \"19:00\",\n        \"civil_twilight_end\": \"19:27\",\n        \"nautical_twilight_begin\": \"19:27\",\n        \"nautical_twilight_end\": \"19:59\",\n        \"astronomical_twilight_begin\": \"19:59\",\n        \"astronomical_twilight_end\": \"20:31\"\n      },\n      \"night_begin\": \"20:31\",\n      \"sun_status\": \"-\",\n      \"solar_noon\": \"12:40\",\n      \"day_length\": \"12:40\",\n      \"moon_phase\": \"WAXING_CRESCENT\",\n      \"moonrise\": \"08:45\",\n      \"moonset\": \"22:10\",\n      \"moon_status\": \"-\"\n    },\n    {\n      \"date\": \"2026-03-19\",\n      \"mid_night\": \"00:06\",\n      \"night_end\": \"04:47\",\n      \"morning\": {\n        \"astronomical_twilight_begin\": \"04:47\",\n        \"astronomical_twilight_end\": \"05:19\",\n        \"nautical_twilight_begin\": \"05:19\",\n        \"nautical_twilight_end\": \"05:51\",\n        \"civil_twilight_begin\": \"05:51\",\n        \"civil_twilight_end\": \"06:18\",\n        \"blue_hour_begin\": \"05:40\",\n        \"blue_hour_end\": \"06:01\",\n        \"golden_hour_begin\": \"06:01\",\n        \"golden_hour_end\": \"06:55\"\n      },\n      \"sunrise\": \"06:18\",\n      \"sunset\": \"19:02\",\n      \"evening\": {\n        \"golden_hour_begin\": \"18:25\",\n        \"golden_hour_end\": \"19:18\",\n        \"blue_hour_begin\": \"19:18\",\n        \"blue_hour_end\": \"19:40\",\n        \"civil_twilight_begin\": \"19:02\",\n        \"civil_twilight_end\": \"19:29\",\n        \"nautical_twilight_begin\": \"19:29\",\n        \"nautical_twilight_end\": \"20:01\",\n        \"astronomical_twilight_begin\": \"20:01\",\n        \"astronomical_twilight_end\": \"20:33\"\n      },\n      \"night_begin\": \"20:33\",\n      \"sun_status\": \"-\",\n      \"solar_noon\": \"12:40\",\n      \"day_length\": \"12:44\",\n      \"moon_phase\": \"WAXING_CRESCENT\",\n      \"moonrise\": \"09:30\",\n      \"moonset\": \"23:05\",\n      \"moon_status\": \"-\"\n    }\n  ]\n}"
            },
            {
              "name": "400 Bad Request – Invalid IP or parameter",
              "originalRequest": {},
              "status": "Bad Request",
              "code": 400,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"message\": \"Provided name, service or IP address 'not_an_ip' is not valid.\"\n}"
            },
            {
              "name": "401 Unauthorized – Invalid or missing API key",
              "originalRequest": {},
              "status": "Unauthorized",
              "code": 401,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"message\": \"Provided API key is not valid. Contact technical support for assistance at support@ipgeolocation.io\"\n}"
            },
            {
              "name": "404 Not found– Not in our Database",
              "originalRequest": {},
              "status": "Not Found",
              "code": 404,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"message\": \"Provided IPv4 or IPv6 address does not exist in our database.\"\n}"
            },
            {
              "name": "405 Method Not Allowed – Post used on single endpoint",
              "originalRequest": {},
              "status": "Method Not Allowed",
              "code": 405,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"message\": \"Request method 'POST' is not supported\"\n}"
            },
            {
              "name": "423 Locked – Invalid IP range",
              "originalRequest": {},
              "status": "Locked",
              "code": 423,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"message\": \"'10.0.0.1' is a bogon IP address.\"\n}"
            },
            {
              "name": "429 Too Many Requests – Rate limit hit",
              "originalRequest": {},
              "status": "Too Many Requests",
              "code": 429,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"message\": \"You have exceeded the limit of PLAN_USAGE_LIMIT requests per PLAN_INERVAL for your subscribed PLAN plan. Please throttle your requests or upgrade your plan to continue using IPGeolocation API without interruption.\"\n}"
            },
            {
              "name": "499 Client Closed Request",
              "originalRequest": {},
              "status": "Client Closed Request",
              "code": 499,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"message\": \"Client closed the request before the server could respond.\"\n}"
            },
            {
              "name": "500 Internal Server Error",
              "originalRequest": {},
              "status": "Internal Server Error",
              "code": 500,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"message\": \"Something went wrong on the server side.\"\n}"
            }
          ]
        }
      ]
    }
  ]
}