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
limit	1–200, default 50
cursor	Pagination cursor from a previous nextCursor

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",
      "verifiedAt": "2026-05-05T11:39:19.406Z",
      "createdAt": "2026-05-05T11:39:12.884Z"
    }
  ],
  "nextCursor": "8f09b47c-b42f-4d14-8395-2989db76e6f8"
}

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.
verifiedAt	string | null	When DNS first pointed at our edge.
createdAt	string	ISO 8601 timestamp.
updatedAt	string	ISO 8601 timestamp.