> ## Documentation Index
> Fetch the complete documentation index at: https://docs.squarecloud.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Domains auflisten

> Listet alle über Ihre Anwendungen konfigurierten Hostnamen auf, einschließlich der standardmäßigen squareweb.app-Subdomain und jeder angehängten benutzerdefinierten Domain. Es gilt ein Rate-Limit von 20 Anfragen pro 60 Sekunden.

<ParamField header="Authorization" type="string" placeholder="API Key" required>
  Der API-Schlüssel für Ihr Konto. Sie finden ihn in Ihren [Kontoeinstellungen](https://squarecloud.app/de/account/security).
</ParamField>

<Note>
  Dieser Endpoint akzeptiert entweder Ihren API-Schlüssel oder ein Session-Token (JWT) im `Authorization`-Header. Authentifizierung ist erforderlich — Anfragen ohne sie geben `401` zurück.
</Note>

### Antwort

<ResponseField name="status" type="string">
  Gibt an, ob der Aufruf erfolgreich war. `success` bei Erfolg, `error` andernfalls.
</ResponseField>

Das `response`-Array ist eine flache Liste aller Hostnamen über die Anwendungen, die Ihnen gehören. Benutzerdefinierte Domains kommen zuerst, gefolgt von den standardmäßigen `*.squareweb.app`-Subdomains. Anwendungen ohne Web-Domain (z. B. Worker und Bots) werden ausgelassen.

<Info>
  Diese Liste wird aus der zwischengespeicherten Projektliste bereitgestellt und wird daher **nicht** auf die Netzwerk-Rate-Limits pro Anwendung angerechnet.
</Info>

<ResponseField name="response" type="array">
  Die Liste der Hostnamen.

  <Expandable title="Objekt umschalten">
    <ResponseField name="app_id" type="string">
      Der 24-stellige hexadezimale Bezeichner der Anwendung, der die Domain gehört.
    </ResponseField>

    <ResponseField name="hostname" type="string">
      Der vollständig qualifizierte Hostname.
    </ResponseField>

    <ResponseField name="type" type="string">
      `"subdomain"` für den standardmäßigen `*.squareweb.app`-Host; `"custom"` für eine angehängte benutzerdefinierte Domain.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseExample>
  ```json theme={null}
  {
    "status": "success",
    "response": [
      { "app_id": "abc123def456abc123def456", "hostname": "example.com", "type": "custom" },
      { "app_id": "abc123def456abc123def456", "hostname": "my-app.squareweb.app", "type": "subdomain" }
    ]
  }
  ```
</ResponseExample>