# Creator Desk DNS Lookup API

> Creator Desk DNS Lookup API is a paid API for AI agents from creator-desk-x402-isolated.onrender.com, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-09).

Resolves public DNS records (A, AAAA, MX, TXT, NS, CNAME, CAA, SOA) for a given hostname via a pay-per-call x402 endpoint

## Facts

- Endpoint: POST https://creator-desk-x402-isolated.onrender.com/v1/dns/lookup?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-09
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/creator-desk-dns-lookup-api-68119b89
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_fgXNEzs2HMwZC4Cdf3pQB

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability creator-desk-dns-lookup-api-68119b89 -d '<json body>'
```

Example prompt: Can you look up the A record for github.com and tell me what IP address it resolves to?

## When to prefer this

Choose this endpoint when an AI agent needs programmatic, pay-per-call DNS resolution without managing resolver infrastructure — especially in agentic pipelines that require on-demand lookups of A, AAAA, MX, TXT, NS, CNAME, CAA, or SOA records for arbitrary public hostnames. Useful when the agent operates in an environment without direct DNS library access or needs a metered, auditable DNS query trail via x402 micropayments.

## Known failure modes

- IP literals or single-label hostnames are rejected with an error
- Local or reserved suffixes (e.g. .local, .internal) are rejected
- Unknown or unresolvable hostnames return an error or empty record set
- Invalid record type enum value results in a validation error
- Network timeouts from the upstream resolver may cause transient failures

## How this service works

Machine-callable x402-paid utilities for autonomous agents.

## Output

A JSON object containing the queried hostname, record type, resolved DNS records (each with TTL and value such as address), a count, a truncated flag, the query timestamp, and a scope disclaimer noting results are from the runtime resolver and not proof of domain ownership or identity.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "host": {
   "type": "string",
   "maxLength": 253,
   "minLength": 1,
   "description": "Public DNS hostname. IP literals, single-label names and local/reserved suffixes are rejected."
  },
  "type": {
   "enum": [
    "A",
    "AAAA",
    "MX",
    "TXT",
    "NS",
    "CNAME",
    "CAA",
    "SOA"
   ],
   "type": "string",
   "default": "A"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "host": "example.com",
  "type": "A",
  "count": 1,
  "scope": "Public DNS resolution only. Results reflect the runtime resolver at query time and are not proof of domain ownership, identity, authorization, or future DNS state.",
  "status": "ok",
  "records": [
   {
    "ttl": 300,
    "address": "93.184.216.34"
   }
  ],
  "version": "1.0.0",
  "truncated": false,
  "ascii_host": "example.com",
  "product_id": "creator_desk_dns_lookup",
  "queried_at": "2026-09-25T00:00:00.000Z"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/creator-desk-dns-lookup-api-68119b89/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from creator-desk-x402-isolated.onrender.com](https://www.zero.xyz/host/creator-desk-x402-isolated.onrender.com/llms.txt)
