# ipv4.fr DNS Lookup API

> ipv4.fr DNS Lookup API is a paid API for AI agents from ipv4.fr, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-29).

Performs DNS record lookups for a given domain, returning A, AAAA, MX, TXT, CNAME, NS, and SOA records.

## Facts

- Endpoint: GET https://ipv4.fr/x402/v1/dns/%7Bdomain%7D?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-29
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/ipv4-fr-dns-lookup-api-8f6cddb2
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_-VHVsOAlUFMLIIhTHaKgG

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 ipv4-fr-dns-lookup-api-8f6cddb2
```

Example prompt: Can you look up the DNS records for github.com — specifically the A, MX, and TXT records?

## When to prefer this

Choose this endpoint when you need a quick, programmatic DNS lookup without standing up your own resolver. It is especially useful for verifying DNS configuration, checking email routing (MX records), or resolving IPs in automated workflows. At $0.002/call it is cost-effective for on-demand lookups. Prefer it over generic WHOIS tools when the specific need is structured DNS record data rather than registrar ownership information.

## Known failure modes

- Domain does not exist — returns empty or error response
- Invalid domain format — may return 400 or empty results
- Requested record type not found — returns empty array for that type
- DNS propagation delays — may return stale or missing records
- Network timeout reaching upstream DNS resolvers

## How this service works

Fast, reliable network tools API. IP geolocation, DNS lookup, SSL check, WHOIS, email validation, port scan. Free tier available.

## Output

A JSON object keyed by DNS record type (e.g. A, MX, TXT, CNAME, NS, SOA), each containing an array of resolved values. For MX records, includes exchange hostname and priority. The domain name queried is also returned in the 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"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "pathParams": {
     "type": "object",
     "required": [
      "domain"
     ],
     "properties": {
      "domain": {
       "type": "string",
       "description": "Domain name"
      }
     }
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "types": {
       "type": "string",
       "description": "Comma separated record types: A,AAAA,MX,TXT,CNAME,NS,SOA"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "A": [
   "93.184.215.14"
  ],
  "MX": [
   {
    "exchange": "mail.example.com",
    "priority": 10
   }
  ],
  "domain": "example.com"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/ipv4-fr-dns-lookup-api-8f6cddb2/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from ipv4.fr](https://www.zero.xyz/host/ipv4.fr/llms.txt)