List domains

GET /v1/domains

Returns every domain in the workspace tied to your API key. Cursor-paginated.

Request

curl https://api.domainee.dev/v1/domains \
  -H "Authorization: Bearer $DOMAINEE_API_KEY"

Query parameters

Param	Notes
status	Filter: pending · verified · failed · expired
hostname	Exact-match lookup (case-insensitive). Returns at most one domain; nextCursor is always null. Saves you paging the whole workspace when you only need one domain.
limit	1–200, default 50
cursor	Pagination cursor from a previous nextCursor

Looking up by hostname

curl "https://api.domainee.dev/v1/domains?hostname=shop.acme.com" \
  -H "Authorization: Bearer $DOMAINEE_API_KEY"

Empty domains array if no match — never a 404.

Response — 200 OK

{
  "domains": [
    {
      "id": "8f09b47c-b42f-4d14-8395-2989db76e6f8",
      "hostname": "shop.acme.com",
      "originUrl": "https://acme.fly.dev",
      "status": "verified",
      "mode": "proxy",
      "monitorStatus": "active_ssl",
      "metadata": { "orderId": "ord_123", "tenant": "acme" },
      "verifiedAt": "2026-05-05T11:39:19.406Z",
      "createdAt": "2026-05-05T11:39:12.884Z"
    }
  ],
  "nextCursor": "8f09b47c-b42f-4d14-8395-2989db76e6f8"
}

Whatever you stored in metadata at create time round-trips on every list — useful for stitching domains back to your own records (workspace, tenant, customer id, etc.) without a separate lookup table.

nextCursor is null once you've reached the last page. Pass it back as ?cursor=... to get the following page.

The Domain object

Full field reference for the objects returned in domains[]:

Field	Type	Notes
id	string	UUID. Use it on GET/PATCH/DELETE.
hostname	string	The customer's hostname. Lowercase, RFC-1123.
originUrl	string	URL we forward to (proxy mode) or redirect to (redirect mode).
status	enum	pending · verified · failed · expired. Driven by DNS state.
mode	enum	proxy (default) — reverse-proxy traffic. redirect — return 301/302.
keepHost	boolean	proxy mode only: forward customer's Host header instead of rewriting.
redirectWww	boolean	If true, also issue cert for the www variant and 301 it to canonical.
redirectStatus	301 | 302	HTTP code for redirect mode.
dnsRecords	array	The records the customer must publish.
isResolving	boolean	Whether DNS resolves the hostname at all.
pointsToEdge	boolean	Whether DNS points to our edge IPs.
dnsPointedAt	string[]	Snapshot of resolved IPs from last probe.
monitorStatus	enum	Computed health. See Monitor states.
monitorMessage	string	Human-readable explanation of monitorStatus.
metadata	object	Whatever you sent on Create, echoed back verbatim. Useful for keying domains to records on your side.
verifiedAt	string | null	When DNS first pointed at our edge.
createdAt	string	ISO 8601 timestamp.
updatedAt	string	ISO 8601 timestamp.