# List Custom Domains for Site Slug

> List Custom Domains for Site Slug is a paid API for AI agents from site.withzero.ai, paid per call via MPP, metered — billed by usage, status unknown (last checked 2026-09-29).

Returns all custom domains attached to a specific hosted site slug, readable only by the site owner.

## Facts

- Endpoint: GET https://site.withzero.ai/sites/:slug/domains?utm_source=zero.xyz
- Price: metered — billed by usage
- Payment: MPP
- Status: unknown
- Last checked: 2026-09-29
- Activations on Zero: 0
- Provider: site.withzero.ai
- Website: https://site.withzero.ai
- Canonical page: https://www.zero.xyz/c/site-withzero-ai-list-custom-domains-for-site-slug-f459cee3
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_rKqd52LJDMqwIqUthf_w9

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 site-withzero-ai-list-custom-domains-for-site-slug-f459cee3
```

Example prompt: What custom domains are currently attached to my site slug 'my-portfolio-2024'?

## When to prefer this

Use this endpoint when you need to quickly audit or enumerate custom domains associated with a specific slug for the authenticated owner. It reads directly from the CUSTOM_DOMAINS KV store for fast lookup, but be aware it does not cross-check live Cloudflare state — prefer this for administrative inventory rather than authoritative DNS verification.

## Known failure modes

- Slug not found — no such slug exists for the authenticated owner
- Unauthorized — caller does not own the slug
- Empty list returned if no custom domains are attached
- KV read errors if the store is temporarily unavailable
- Stale data — KV state may differ from actual Cloudflare DNS state

## How this service works

List custom domains attached to this slug. Owner-only. Reads from CUSTOM_DOMAINS KV — does not cross-check Cloudflare state.

## Output

Returns an object listing all custom domains currently mapped to the specified slug in the CUSTOM_DOMAINS KV store. Note: this reflects stored KV state only and does not verify live Cloudflare DNS configuration.

## Response schema (JSON Schema)

```json
{
 "type": "object"
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/site-withzero-ai-list-custom-domains-for-site-slug-f459cee3/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from site.withzero.ai](https://www.zero.xyz/host/site.withzero.ai/llms.txt)