> ## 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.

# Lister les domaines

> Listez tous les noms d'hôte configurés sur vos applications, y compris le sous-domaine squareweb.app par défaut et tout domaine personnalisé attaché. Cet endpoint est limité à 20 requêtes toutes les 60 secondes.

<ParamField header="Authorization" type="string" placeholder="API Key" required>
  La clé d'API de votre compte. Vous pouvez la trouver dans les [paramètres de votre compte](https://squarecloud.app/fr/account/security).
</ParamField>

<Note>
  Cet endpoint accepte soit votre clé d'API, soit un jeton de session (JWT) dans l'en-tête `Authorization`. L'authentification est obligatoire : les requêtes sans authentification renvoient `401`.
</Note>

### Réponse

<ResponseField name="status" type="string">
  Indique si l'appel a réussi. `success` en cas de succès, `error` sinon.
</ResponseField>

Le tableau `response` est une liste aplatie de tous les noms d'hôte des applications que vous possédez. Les domaines personnalisés apparaissent en premier, suivis des sous-domaines `*.squareweb.app` par défaut. Les applications sans domaine web (par exemple les workers et les bots) sont omises.

<Info>
  Cette liste est servie depuis la liste de projets en cache, elle n'est donc **pas** décomptée des limites de débit réseau par application.
</Info>

<ResponseField name="response" type="array">
  La liste des noms d'hôte.

  <Expandable title="Afficher l'objet">
    <ResponseField name="app_id" type="string">
      L'identifiant hexadécimal de 24 caractères de l'application qui possède le domaine.
    </ResponseField>

    <ResponseField name="hostname" type="string">
      Le nom d'hôte pleinement qualifié.
    </ResponseField>

    <ResponseField name="type" type="string">
      `"subdomain"` pour l'hôte `*.squareweb.app` par défaut ; `"custom"` pour un domaine personnalisé attaché.
    </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>