# Macaroon Network Domain DNS Check

> Macaroon Network Domain DNS Check is a paid API for AI agents from api.macaroonnetwork.com, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-15).

Performs a live DNS resolution check on a domain and returns whether it resolves along with its IPv4/IPv6 addresses

## Facts

- Endpoint: POST https://api.macaroonnetwork.com/execute/domain-dns-check-v1
- 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/macaroon-network-domain-dns-check-c19dd98c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Xk8_iM8IUI2IGhzgYyZ-q

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 macaroon-network-domain-dns-check-c19dd98c -d '<json body>'
```

Example prompt: Before I interact with this merchant's site, can you do a live DNS check on checkout.acmeshop.com and tell me if it resolves and what IP addresses it points to?

## When to prefer this

Choose this endpoint when you need a real-time, direct DNS protocol resolution check with no reliance on cached, scraped, or third-party WHOIS/registry data. It is ideal for agent safety checks before interacting with unknown websites or merchants, for confirming newly configured domains are live, or for any workflow requiring a fresh DNS answer rather than a stale dataset lookup.

## Known failure modes

- Domain does not exist or has no DNS records — returns non-resolving status
- Malformed domain name input — may return validation error
- DNS timeout or temporary resolution failure — may return error or non-resolving result
- Network connectivity issue to DNS servers at query time

## How this service works

Part of the Domain Web Trust family: live DNS resolution check for a domain, useful for confirming a domain has valid DNS before an agent interacts with a website or merchant. Reports whether it resolves and to which IPv4/IPv6 addresses. Queries the public DNS protocol directly at request time -- no third-party dataset, no cached or scraped WHOIS/registry data, so there is no resale-terms question.

## Output

Returns whether the queried domain successfully resolves in live DNS, along with the IPv4 and/or IPv6 addresses it resolves to at request time — sourced directly from the public DNS protocol with no caching or third-party dataset.

## 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": {
     "type": "object"
    },
    "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/macaroon-network-domain-dns-check-c19dd98c/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.macaroonnetwork.com](https://www.zero.xyz/host/api.macaroonnetwork.com/llms.txt)
