# Forest Infra DNS Lookup

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

Resolves a single public DNS record type (A, AAAA, CNAME, MX, NS, TXT) for a hostname into normalized answers with TTL and authority metadata.

## Facts

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

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-lookup-52eaee82 -d '<json body>'
```

Example prompt: Look up the A record for api.example.com and tell me what IP address it resolves to.

## When to prefer this

Choose this endpoint when you need to programmatically resolve a single bounded DNS record type for a public hostname with normalized output and guaranteed safety guardrails (no AXFR, no private-network probing). Ideal for infrastructure agents, domain validation workflows, and situations where you need structured DNS data with TTL and authority metadata rather than raw resolver output.

## Known failure modes

- Invalid hostname format (doesn't match ^[a-z0-9.-]+$ pattern) returns validation error
- Unsupported record type (anything other than A, AAAA, CNAME, MX, NS, TXT) is rejected
- NXDOMAIN or non-existent hostname returns empty answer set
- Private/reserved network hostnames are blocked
- AXFR zone transfer attempts are blocked
- TTL and authority fields may be null if unavailable from the resolver
- Payment of $0.001 USDC required per call via x402; missing payment results in 402 response

## How this service works

Resolve one bounded public DNS record type into normalized answers. AXFR, resolver abuse and private-network probing are blocked; TTL and authority are null when unavailable. Base mainnet USDC

## Output

Returns normalized DNS answer records for the queried record type, including the resolved values (e.g. IP addresses, hostnames, priorities), TTL (when available), and authority information (when available). AXFR zone transfers, private-network probing, and resolver abuse are blocked.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "name": {
   "type": "string",
   "pattern": "^[a-z0-9.-]+$",
   "maxLength": 253,
   "description": "Public DNS hostname to resolve."
  },
  "type": {
   "enum": [
    "A",
    "AAAA",
    "CNAME",
    "MX",
    "NS",
    "TXT"
   ],
   "description": "DNS record type to query."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/forest-infra-dns-lookup-52eaee82/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)
