UtilityActive

WHOIS Lookup

Domain registration lookup via RDAP (modern WHOIS). Returns registrar, registrar_url, created_at, updated_at, expires_at, days_until_expiry, name_servers array, status array, and registrant_country. Clean JSON — no raw WHOIS text to parse. Covers all major TLDs.

Endpointx402 Payment Required

POST

https://agentsvc.io/api/v1/proxy/whois

Price

$0.002 USDC

Latency P99

~700ms

Provider

agentsvc.io

Input Schema

{
  "type": "object",
  "required": [
    "domain"
  ],
  "properties": {
    "domain": {
      "type": "string",
      "description": "Domain to look up (e.g. 'github.com', 'openai.com'). Include TLD, exclude https://"
    }
  }
}

Output Schema

{
  "type": "object",
  "required": [
    "domain",
    "status",
    "name_servers"
  ],
  "properties": {
    "domain": {
      "type": "string",
      "description": "The queried domain name"
    },
    "registrar": {
      "type": "string",
      "description": "Domain registrar name"
    },
    "registrar_url": {
      "type": "string",
      "description": "Registrar website URL"
    },
    "status": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Domain status codes (e.g. clientTransferProhibited)"
    },
    "created_at": {
      "type": "string",
      "format": "date-time",
      "description": "Domain registration date (ISO 8601)"
    },
    "updated_at": {
      "type": "string",
      "format": "date-time",
      "description": "Last updated date (ISO 8601)"
    },
    "expires_at": {
      "type": "string",
      "format": "date-time",
      "description": "Domain expiry date (ISO 8601)"
    },
    "days_until_expiry": {
      "type": "integer",
      "description": "Days remaining until domain expires (negative = already expired)"
    },
    "name_servers": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Nameservers for the domain"
    },
    "dnssec": {
      "type": "string",
      "description": "DNSSEC status (e.g. 'signedDelegation', 'unsigned')"
    },
    "registrant_country": {
      "type": "string",
      "description": "Registrant country code (if publicly available)"
    }
  },
  "example": {
    "domain": "github.com",
    "registrar": "MarkMonitor Inc.",
    "registrar_url": "http://www.markmonitor.com",
    "status": [
      "clientDeleteProhibited",
      "clientTransferProhibited",
      "clientUpdateProhibited"
    ],
    "created_at": "2007-10-09T18:20:50.000Z",
    "updated_at": "2024-09-08T09:18:28.000Z",
    "expires_at": "2026-10-09T18:20:50.000Z",
    "days_until_expiry": 548,
    "name_servers": [
      "dns1.p08.nsone.net",
      "dns2.p08.nsone.net",
      "ns-1283.awsdns-32.org",
      "ns-1707.awsdns-21.co.uk"
    ],
    "dnssec": "unsigned",
    "registrant_country": "US"
  }
}

Code Examples

# Step 1: Call without payment → receive 402 with requirements
curl -X POST "https://agentsvc.io/api/v1/proxy/whois" \
  -H "Content-Type: application/json" \
  -d '{
  "domain": "your_domain"
}'

# Step 2: Sign payment using x402 SDK, then retry
curl -X POST "https://agentsvc.io/api/v1/proxy/whois" \
  -H "Content-Type: application/json" \
  -H "X-Payment: x402 usdc base <your-signed-payment>" \
  -d '{
  "domain": "your_domain"
}'

WHOIS Lookup

Input Schema

Output Schema

Code Examples

Tags

Service Info