UtilityActive

DNS Lookup

Resolve DNS records for any domain. Supports A, AAAA, MX, TXT, CNAME, NS. Returns records object with array per type. Default: A records only. Use to verify mail server setup (MX), check domain ownership (TXT), or debug DNS propagation.

Endpointx402 Payment Required

POST

https://agentsvc.io/api/v1/proxy/dns-lookup

Price

$0.001 USDC

Latency P99

~300ms

Provider

agentsvc.io

Input Schema

{
  "type": "object",
  "required": [
    "domain"
  ],
  "properties": {
    "domain": {
      "type": "string",
      "description": "Domain name to look up (e.g. 'example.com', 'mail.google.com')"
    },
    "types": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "A",
          "AAAA",
          "MX",
          "TXT",
          "CNAME",
          "NS"
        ]
      },
      "default": [
        "A"
      ],
      "description": "DNS record types to resolve. Default: [\"A\"]. Supported: A, AAAA, MX, TXT, CNAME, NS"
    }
  }
}

Output Schema

{
  "type": "object",
  "required": [
    "domain",
    "records",
    "resolved_at"
  ],
  "properties": {
    "domain": {
      "type": "string",
      "description": "The queried domain name"
    },
    "records": {
      "type": "object",
      "description": "Map of DNS record type → array of records",
      "properties": {
        "A": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "IPv4 addresses"
        },
        "AAAA": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "IPv6 addresses"
        },
        "MX": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "priority": {
                "type": "integer"
              },
              "exchange": {
                "type": "string"
              }
            }
          },
          "description": "Mail exchange records"
        },
        "TXT": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "TXT records (joined entries)"
        },
        "CNAME": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "Canonical name records"
        },
        "NS": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "Nameserver records"
        }
      }
    },
    "resolved_at": {
      "type": "string",
      "format": "date-time",
      "description": "ISO 8601 timestamp of the lookup"
    }
  },
  "example": {
    "domain": "example.com",
    "records": {
      "A": [
        "93.184.216.34"
      ],
      "MX": [
        {
          "priority": 10,
          "exchange": "mail.example.com"
        }
      ]
    },
    "resolved_at": "2026-04-07T12:00:00.000Z"
  }
}

Code Examples

# Step 1: Call without payment → receive 402 with requirements
curl -X POST "https://agentsvc.io/api/v1/proxy/dns-lookup" \
  -H "Content-Type: application/json" \
  -d '{
  "domain": "example.com",
  "types": [
    "A",
    "MX"
  ]
}'

# Step 2: Sign payment using x402 SDK, then retry
curl -X POST "https://agentsvc.io/api/v1/proxy/dns-lookup" \
  -H "Content-Type: application/json" \
  -H "X-Payment: x402 usdc base <your-signed-payment>" \
  -d '{
  "domain": "example.com",
  "types": [
    "A",
    "MX"
  ]
}'

DNS Lookup

Input Schema

Output Schema

Code Examples

Tags

Service Info