# Quartermaster DNS-over-HTTPS Resolver

> Quartermaster DNS-over-HTTPS Resolver is a paid API for AI agents from quartermaster.surewhynot.app, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-15).

Resolves DNS records for a given hostname via DNS-over-HTTPS and returns structured JSON results supporting A, AAAA, CNAME, MX, NS, TXT, SOA, SRV, CAA, PTR, DNSKEY, DS, HTTPS, and SVCB record types.

## Facts

- Endpoint: GET https://quartermaster.surewhynot.app/v1/dns
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/quartermaster-dns-over-https-resolver-482a4f60
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_fW-920rtoi8yJxbDll7a7

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 quartermaster-dns-over-https-resolver-482a4f60
```

Example prompt: Look up the MX records for gmail.com so I can see which mail servers handle its email.

## When to prefer this

Use this endpoint when an AI agent needs programmatic, structured DNS resolution without relying on system-level DNS or shell commands. Ideal for infrastructure automation, security audits, email deliverability checks (MX/TXT/SPF/DKIM), DNSSEC validation workflows, and any agent pipeline that needs machine-readable DNS data via a simple HTTP GET with x402 micropayment.

## Known failure modes

- Hostname does not exist — NXDOMAIN response returned
- Invalid DNS record type requested — validation error
- Network timeout reaching upstream DNS resolver
- Malformed hostname input — query parameter validation error
- DNSSEC validation failure for security record types
- Payment not completed — 402 response before result is returned

## How this service works

Resolve DNS records using DNS-over-HTTPS and return structured JSON for infrastructure, security, and agent workflows.

## Output

A structured JSON object containing the resolved DNS records for the queried hostname and record type, including record values, TTL, and any additional DNS response metadata.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "name"
 ],
 "properties": {
  "name": {
   "type": "string",
   "description": "Hostname to resolve"
  },
  "type": {
   "enum": [
    "A",
    "AAAA",
    "CNAME",
    "MX",
    "NS",
    "TXT",
    "SOA",
    "SRV",
    "CAA",
    "PTR",
    "DNSKEY",
    "DS",
    "HTTPS",
    "SVCB"
   ],
   "type": "string",
   "description": "Record type"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object"
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/quartermaster-dns-over-https-resolver-482a4f60/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from quartermaster.surewhynot.app](https://www.zero.xyz/host/quartermaster.surewhynot.app/llms.txt)
