# DNS Record Lookup

> DNS Record Lookup is a paid API for AI agents from data.greeneris.io, paid per call via x402, $0.002/call, status unknown (last checked 2026-09-15).

Resolves DNS records (A, AAAA, MX, TXT, NS, CNAME) for a domain, or returns a combined email-deliverability check (MX + SPF + DMARC) via Cloudflare DNS-over-HTTPS

## Facts

- Endpoint: GET https://data.greeneris.io/v1/domain/dns
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/dns-record-lookup-cfb540c2
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_zzge5VSYx8nAWN7okyTUF

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 dns-record-lookup-cfb540c2
```

Example prompt: Can you look up the MX records for anthropic.com so I know which mail servers handle their email? Also check if they have SPF and DMARC set up.

## When to prefer this

Choose this endpoint when you need live DNS resolution backed by Cloudflare's 1.1.1.1 DoH for reliability and speed, especially for email-deliverability checks combining MX + SPF + DMARC in a single call. Prefer over generic DNS tools when you want pay-per-call pricing with no account setup required.

## Known failure modes

- Domain does not exist — returns empty records or NXDOMAIN
- Invalid DNS record type enum — 400 bad request
- No MX records found for domain — empty records array
- Payment not provided — HTTP 402 with machine-readable USDC quote on Base
- Transient DNS resolution failure from upstream Cloudflare resolver

## How this service works

Live DNS records resolved via Cloudflare 1.1.1.1 DNS-over-HTTPS (public facts, real time). Query: ?name=anthropic.com&type=MX (type in A|AAAA|MX|TXT|NS|CNAME, default MX). Or ?name=anthropic.com&check=email -> combined MX + SPF + DMARC with an email_ready boolean, useful before emailing or invoicing a contact. JSON with records list; 5 min cache.

## Output

Returns a JSON object containing the DNS record type, domain queried, data source (Cloudflare 1.1.1.1 DoH), and an array of records each with TTL, name, and data fields. For email checks, returns combined MX, SPF, and DMARC records in one response. Record count is included.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "name"
     ],
     "properties": {
      "name": {
       "type": "string",
       "description": "Domain to resolve, e.g. anthropic.com"
      },
      "type": {
       "enum": [
        "A",
        "AAAA",
        "MX",
        "TXT",
        "NS",
        "CNAME"
       ],
       "type": "string",
       "default": "MX",
       "description": "DNS record type"
      },
      "check": {
       "enum": [
        "email"
       ],
       "type": "string",
       "description": "check=email returns combined MX + SPF + DMARC instead of raw records"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "type": "MX",
  "domain": "anthropic.com",
  "source": "Cloudflare 1.1.1.1 DNS-over-HTTPS (live resolution)",
  "records": [
   {
    "ttl": 1800,
    "data": "1 aspmx.l.google.com.",
    "name": "anthropic.com"
   }
  ],
  "record_count": 1
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/dns-record-lookup-cfb540c2/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from data.greeneris.io](https://www.zero.xyz/host/data.greeneris.io/llms.txt)