> ## 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 load balancers

> Listez les load balancers de domaine personnalisé du compte. Limité à 20 requêtes toutes les 60 secondes.

Groupe les applications du compte par domaine personnalisé rattaché. Chaque domaine personnalisé apparaît comme un groupe avec les applications qui le desservent ; un groupe de deux applications ou plus est un load balancer actif, où le trafic est réparti entre les applications au niveau de l'edge avec basculement automatique lorsque l'une est hors ligne.

Rattachez le même domaine à plusieurs applications avec la route [Définir un domaine personnalisé](/fr/api-reference/endpoint/apps/network/custom).

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

### Réponse

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

<ResponseField name="response" type="object">
  <Expandable title="properties" defaultOpen>
    <ResponseField name="limit" type="integer">
      Nombre maximum d'applications autorisées sur un même domaine pour le plan du compte : 2 sur Standard, 5 sur Pro, 10 sur Enterprise.
    </ResponseField>

    <ResponseField name="balancers" type="array">
      Domaines personnalisés groupés par nom d'hôte. Tableau vide lorsqu'aucune application n'a de domaine personnalisé.

      <Expandable title="properties">
        <ResponseField name="hostname" type="string">
          Le domaine personnalisé.
        </ResponseField>

        <ResponseField name="apps" type="array">
          Applications desservant ce domaine (`id`, `name`, et le `cluster` hébergeant actuellement chacune).
        </ResponseField>
      </Expandable>
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseExample>
  ```json theme={null}
  {
    "status": "success",
    "response": {
      "limit": 2,
      "balancers": [
        {
          "hostname": "example.com",
          "apps": [
            { "id": "abc123def456abc123def456", "name": "web-1", "cluster": "suki-cluster" },
            { "id": "def456abc123def456abc123", "name": "web-2", "cluster": "nasa-cluster" }
          ]
        }
      ]
    }
  }
  ```
</ResponseExample>
