Api Endpoint

Geographic DNS Lookup

Geo-located DNS resolution — resolve hostnames from specific countries to see how CDNs, geo-blocking, and DNS-based routing differ by region.

Open interactive test console

Offering

Provider: geodns.iwsolutions.ca
Method: POST
Offering type: Api Endpoint
Transport type: http
Category: Infrastructure
Delivery: Not provided
Pricing model: Not provided
x402 version: 2

Endpoint context

URL: https://geodns.iwsolutions.ca/api/resolve
MIME type: Not provided
First seen: 2026-10-16T01:50:06.715Z
Last seen: 2026-11-01T14:57:12.185Z
Tags: DNS, Geo, Network, CDN

Website

Payment pricing

x402 payment terms are the authoritative price for calling this endpoint.

Payment option 1: 0.005 USDC
Atomic price: 5000 · Network: eip155:8453 · Asset: USDC · Scheme: exact

Raw x402 terms

[
  {
    "scheme": "exact",
    "network": "eip155:8453",
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "amount": "5000",
    "payTo": "0xDd85eD9E404d22c137a5d9Fc3C200847aa3B11CF"
  }
]

Observed health

Status: Healthy
Latest latency: 87 ms
Average latency: 212 ms
HTTP status: 200
Last checked: 2026-11-02T15:01:01.469Z
Reachability: 100% over 14 checks

Latency is measured to the first response headers. A reachable result does not verify response accuracy or merchant identity.

Input schema

{
  "additionalProperties": false,
  "properties": {
    "body": {
      "properties": {
        "countries": {
          "description": "ISO 3166-1 alpha-2 country codes (up to 20)",
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "hostname": {
          "description": "Domain name to resolve",
          "type": "string"
        },
        "record_type": {
          "description": "DNS record type: A, AAAA, CNAME, MX, TXT, NS",
          "type": "string"
        }
      },
      "required": [
        "hostname",
        "countries"
      ],
      "type": "object"
    },
    "bodyType": {
      "enum": [
        "json",
        "form-data",
        "text"
      ],
      "type": "string"
    },
    "method": {
      "enum": [
        "POST"
      ],
      "type": "string"
    },
    "type": {
      "const": "http",
      "type": "string"
    }
  },
  "required": [
    "type",
    "method",
    "bodyType",
    "body"
  ],
  "type": "object"
}

Output schema

{
  "properties": {
    "example": {
      "properties": {
        "hostname": {
          "type": "string"
        },
        "pricing": {
          "properties": {
            "base_fee": {
              "type": "string"
            },
            "per_country": {
              "type": "string"
            },
            "total_charged": {
              "type": "string"
            }
          },
          "type": "object"
        },
        "record_type": {
          "type": "string"
        },
        "results": {
          "items": {
            "properties": {
              "country": {
                "description": "ISO 3166-1 alpha-2 code",
                "type": "string"
              },
              "error": {
                "description": "Error message if resolution failed",
                "type": "string"
              },
              "records": {
                "description": "Resolved DNS records",
                "items": {
                  "type": "string"
                },
                "type": "array"
              },
              "resolved_at": {
                "description": "ISO 8601 timestamp",
                "type": "string"
              },
              "resolver": {
                "description": "Resolver location label",
                "type": "string"
              },
              "response_ms": {
                "description": "Resolution time in milliseconds",
                "type": "integer"
              },
              "ttl": {
                "description": "Time to live in seconds",
                "type": "integer"
              }
            },
            "type": "object"
          },
          "type": "array"
        }
      },
      "type": "object"
    },
    "type": {
      "type": "string"
    }
  },
  "required": [
    "type"
  ],
  "type": "object"
}