# BitBooth DNS Lookup

> BitBooth DNS Lookup is a paid API for AI agents from app.heinrichstech.com, paid per call via x402, $0.002/call, status unknown (last checked 2026-09-14).

Resolves DNS records (A, AAAA, MX, TXT, NS, CNAME, SOA, SRV, CAA) for any public hostname via a paid x402 micro-transaction API

## Facts

- Endpoint: POST https://app.heinrichstech.com/v1/cdp/dns
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/bitbooth-dns-lookup-f1683e7f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_lCp9_etsevBGtX0q7Mcwh

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 bitbooth-dns-lookup-f1683e7f -d '<json body>'
```

Example prompt: Can you pull all the DNS records for sendgrid.net — I need to see the MX, TXT, and A records to debug why our emails aren't delivering?

## When to prefer this

Choose this endpoint when an agent needs programmatic, structured DNS record data for any public hostname without setting up DNS tooling. It is ideal for infrastructure inspection, email deliverability debugging, pre-flight checks before connecting to a service, or security audits of DNS configuration. Prefer this over raw DNS libraries when running in a sandboxed environment or when you need a consistent, paid API with a timeout guarantee. It covers all major record types in one call, making it more convenient than querying each type separately.

## Known failure modes

- Input is an IP address rather than a hostname — rejected with validation error
- Hostname resolves to a private or loopback address — blocked by security policy
- DNS resolution times out after 5 seconds — returns timeout error
- Hostname does not exist (NXDOMAIN) — returns empty or error response
- Malformed hostname input — returns validation error
- Payment failure or insufficient USDC balance — x402 payment required error

## How this service works

BitBooth DNS: pay 0.002 USDC, get DNS records (A, AAAA, MX, TXT, NS, CNAME, SOA, SRV, CAA) for any hostname. Built on Node's built-in resolver with a 5s timeout cap. Rejects IP-address inputs and private/loopback hosts. Built for agents inspecting infra, debugging delivery, or pre-flighting a target.

## Output

A structured JSON object containing all resolvable DNS record types for the given hostname, including A, AAAA, MX, TXT, NS, CNAME, SOA, SRV, and CAA records where they exist. Each record type is returned as an array of entries with relevant fields (e.g., priority and exchange for MX, value and TTL for TXT). Requests that include IP addresses or private/loopback hostnames are rejected with an error response.

## 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",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "required": [
      "domain"
     ],
     "properties": {
      "domain": {
       "type": "string",
       "description": "RFC-style hostname (1-253 chars). IPv4/IPv6 inputs rejected."
      },
      "recordType": {
       "enum": [
        "A",
        "AAAA",
        "MX",
        "TXT",
        "NS",
        "CNAME",
        "SOA",
        "SRV",
        "CAA"
       ],
       "type": "string",
       "description": "DNS record class to resolve. Defaults to A."
      }
     }
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST",
      "PUT",
      "PATCH"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/bitbooth-dns-lookup-f1683e7f/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from app.heinrichstech.com](https://www.zero.xyz/host/app.heinrichstech.com/llms.txt)