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

# List Load Balancers

> List the account's custom-domain load balancers. Has a rate limit of 20 requests every 60 seconds.

Groups the account's applications by attached custom domain. Every custom domain appears as one group with the applications serving it; a group with two or more applications is an active load balancer, where traffic is balanced across the applications at the edge with automatic failover when one is offline.

Attach the same domain to multiple applications with the [Set Custom Domain](/en/api-reference/endpoint/apps/network/custom) route.

<ParamField header="Authorization" type="string" placeholder="API Key" required>
  The API key for your account. You can find this in your [account settings](https://squarecloud.app/en/account/security).
</ParamField>

### Response

<ResponseField name="status" type="string">
  Indicates whether the call was successful.. `success` if successful, `error` if not.
</ResponseField>

<ResponseField name="response" type="object">
  <Expandable title="properties" defaultOpen>
    <ResponseField name="limit" type="integer">
      Maximum number of applications allowed on one domain for the account's plan: 2 on Standard, 5 on Pro, 10 on Enterprise.
    </ResponseField>

    <ResponseField name="balancers" type="array">
      Custom domains grouped by hostname. Empty array when no application has a custom domain.

      <Expandable title="properties">
        <ResponseField name="hostname" type="string">
          The custom domain.
        </ResponseField>

        <ResponseField name="apps" type="array">
          Applications serving this domain (`id`, `name`, and the `cluster` currently hosting each).
        </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>