# Bloomfilter Domain Registration

> Bloomfilter Domain Registration is a paid API for AI agents from api.bloomfilter.xyz, paid per call via x402, $12.99/call, status unknown (last checked 2026-09-15).

Registers a new domain name for a specified period and optionally sets up DNS records immediately upon registration

## Facts

- Endpoint: POST https://api.bloomfilter.xyz/domains/register
- Price: $12.99/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/bloomfilter-domain-registration-a6deadaf
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_BflFK8zd4PE9IcoKb0r-4

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 bloomfilter-domain-registration-a6deadaf -d '<json body>'
```

Example prompt: Register myawesomestartup.com for two years through Bloomfilter, and immediately set up an A record at the root (@) pointing to 203.0.113.42 with a TTL of 3600.

## When to prefer this

Use this endpoint when you need to register a brand-new domain name and optionally configure DNS records in a single atomic operation, paid via USDC stablecoin through the x402 protocol. Prefer this over manual registrars when automating infrastructure provisioning in an agent workflow that already handles crypto payments.

## Known failure modes

- Domain already registered or unavailable — service may reject with an error
- Invalid domain format — non-FQDN strings will fail schema validation
- Years out of range (must be 1–10) — request rejected
- Invalid DNS record type or missing required record fields — validation error
- Payment failure — x402 payment of $12.99 USDC not fulfilled
- TTL out of range (must be 300–86400) — DNS record creation fails

## How this service works

Register a domain (sample pricing — send request body for exact quote)

## Output

Returns a JSON object confirming the domain is active, including the registered domain name, registration and expiration timestamps, registration period in years, and the assigned nameservers (e.g. ns1.dnsowl.com).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "years": {
   "type": "integer",
   "default": 1,
   "maximum": 10,
   "minimum": 1,
   "description": "Registration period in years"
  },
  "domain": {
   "type": "string",
   "description": "Fully qualified domain name to register (e.g. example.com)"
  },
  "dns_records": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "type",
     "value"
    ],
    "properties": {
     "ttl": {
      "type": "integer",
      "maximum": 86400,
      "minimum": 300
     },
     "host": {
      "type": "string",
      "description": "Record hostname (@ for root)"
     },
     "type": {
      "enum": [
       "A",
       "AAAA",
       "CNAME",
       "MX",
       "TXT",
       "SRV",
       "CAA"
      ],
      "type": "string"
     },
     "value": {
      "type": "string",
      "description": "Record value"
     },
     "priority": {
      "type": "integer",
      "minimum": 0,
      "description": "MX priority / SRV weight"
     }
    }
   },
   "description": "Optional DNS records to create immediately after registration"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "years": 1,
  "domain": "example.com",
  "status": "active",
  "expires_at": "2027-02-22T12:00:00Z",
  "nameservers": [
   "ns1.dnsowl.com",
   "ns2.dnsowl.com",
   "ns3.dnsowl.com"
  ],
  "registered_at": "2026-02-22T12:00:00Z"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/bloomfilter-domain-registration-a6deadaf/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.bloomfilter.xyz](https://www.zero.xyz/host/api.bloomfilter.xyz/llms.txt)