List an app's custom domains

GET/apps/{name}/domains

The custom domains (FQDNs) attached to the app; the ingress proxy routes them and, in terminate mode, obtains a certificate for each. With ?detail=1 the response also carries per-domain TLS/certificate status in 'details'.

path parameters

object

namestringrequired

App name (a DNS label, e.g. web).

query parameters

object

detailboolean

When true, also return per-domain TLS/certificate status in 'details' (including the app's generated <app>.<proxy-domain> name).

Responses

200 OKOK

DomainListResponse

detailsarray

items

DomainDetail

certCertStatus

last_attemptstring | nulldate-time

last_errorstring

not_afterstring | nulldate-time

statestring

domainstring

generatedboolean

tls_modestring

domainsarray | null

items

string

404 Not foundNot Found

ErrorResponse

codestring

errorstring

501 Not Implemented

ErrorResponse

codestring

errorstring

Authentication

bearerAuthHTTP bearer. Daemon API key. Omit on a keyless loopback daemon.

Request

▍GET/apps/{name}/domains

cURL

curl '/apps/{name}/domains?detail='

JavaScript

const response = await fetch("/apps/{name}/domains?detail=", {
  method: "GET",
});
const data = await response.json();

Python

import requests

response = requests.get(
    "/apps/{name}/domains?detail=",
)
data = response.json()

Response

200 OK

{
  "details": [
    {
      "cert": {
        "last_attempt": "2026-01-02T15:04:05Z",
        "last_error": "string",
        "not_after": "2026-01-02T15:04:05Z",
        "state": "string"
      },
      "domain": "string",
      "generated": false,
      "tls_mode": "string"
    }
  ],
  "domains": [
    "string"
  ]
}