# Forest Infra DNS Snapshot

> Forest Infra DNS Snapshot is a paid API for AI agents from http--forest-gas-station-mainnet--lcjl27p8lmjs.code.run, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-22).

Fetches a single-call bounded DNS snapshot for A, AAAA, CNAME, MX, NS, SOA, and TXT record types for a given hostname, with precise status per record type.

## Facts

- Endpoint: POST https://http--forest-gas-station-mainnet--lcjl27p8lmjs.code.run/dns/snapshot?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-22
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/forest-infra-dns-snapshot-a4b0fcb5
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_cOL3GDcRzn8sJ8q1C6mOx

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 forest-infra-dns-snapshot-a4b0fcb5 -d '<json body>'
```

Example prompt: Pull a full DNS snapshot for github.com — I need all record types including A, AAAA, CNAME, MX, NS, SOA, and TXT, and I want to see which ones are missing or returning errors, not just the successful ones.

## When to prefer this

Choose this endpoint when you need a complete, structured DNS snapshot across all major record types in a single call with precise per-type status reporting. It is superior to single-type DNS lookups when you need to audit, verify, or diagnose a domain's full DNS configuration. The explicit distinction between NODATA, NXDOMAIN, and resolver errors — and the partial status for mixed outcomes — makes it ideal for diagnostic or validation workflows where accuracy of failure modes matters, not just successful answers.

## Known failure modes

- Invalid hostname format returns a validation error (pattern mismatch)
- Private or non-public hostnames may not resolve via public DNS-over-HTTPS
- All record types returning errors results in a fully-failed partial snapshot
- Upstream DNS-over-HTTPS resolver outage causes resolver errors across all types
- Payment failure or missing x402 payment header returns HTTP 402

## How this service works

Fetch one bounded public DNS snapshot for A, AAAA, CNAME, MX, NS, SOA and TXT in a single call. Forest uses a fixed public DNS-over-HTTPS resolver, distinguishes answers, NODATA, NXDOMAIN and per-type resolver errors, and marks mixed trustworthy/error outcomes as partial instead of converting resolver failure into an empty DNS result. Base mainnet USDC

## Output

A structured JSON object containing per-record-type results for A, AAAA, CNAME, MX, NS, SOA, and TXT. Each type reports its answer records, or a status of NODATA, NXDOMAIN, or a per-type resolver error. Mixed outcomes (some types resolved, others errored) are marked as partial rather than collapsed into an empty result.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "name": {
   "type": "string",
   "pattern": "^[a-zA-Z0-9.-]+$",
   "maxLength": 253,
   "minLength": 1,
   "description": "Public DNS hostname to resolve."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/forest-infra-dns-snapshot-a4b0fcb5/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from http--forest-gas-station-mainnet--lcjl27p8lmjs.code.run](https://www.zero.xyz/host/http--forest-gas-station-mainnet--lcjl27p8lmjs.code.run/llms.txt)