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

# Listar balanceadores de carga

> Listar os balanceadores de carga de domínio personalizado da conta. Possui limite de taxa de 20 requisições a cada 60 segundos.

Agrupa as aplicações da conta pelo domínio personalizado associado. Cada domínio personalizado aparece como um grupo com as aplicações que o atendem; um grupo com duas ou mais aplicações é um balanceador de carga ativo, no qual o tráfego é balanceado entre as aplicações na edge, com failover automático quando uma delas está offline.

Associe o mesmo domínio a várias aplicações com a rota [Configurar domínio personalizado](/pt-br/api-reference/endpoint/apps/network/custom).

<ParamField header="Authorization" type="string" placeholder="Chave da API" required>
  A chave da API para sua conta. Você pode encontrá-la nas [configurações da conta](https://squarecloud.app/pt-br/account/security).
</ParamField>

### Resposta

<ResponseField name="status" type="string">
  Indica se a chamada foi bem-sucedida. `success` se bem-sucedida, `error` se não.
</ResponseField>

<ResponseField name="response" type="object">
  <Expandable title="propriedades" defaultOpen>
    <ResponseField name="limit" type="integer">
      Número máximo de aplicações permitidas em um mesmo domínio para o plano da conta: 2 no Standard, 5 no Pro, 10 no Enterprise.
    </ResponseField>

    <ResponseField name="balancers" type="array">
      Domínios personalizados agrupados por hostname. Array vazio quando nenhuma aplicação possui domínio personalizado.

      <Expandable title="propriedades">
        <ResponseField name="hostname" type="string">
          O domínio personalizado.
        </ResponseField>

        <ResponseField name="apps" type="array">
          Aplicações que atendem este domínio (`id`, `name` e o `cluster` que hospeda cada uma atualmente).
        </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>
