---
title: "List the account's custom-domain load balancers"
method: GET
path: "/v2/apps/load-balancers"
tags: ["Network"]
---

# List the account's custom-domain load balancers

`GET /v2/apps/load-balancers`

Groups the caller'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 (traffic is balanced across them at the edge, with automatic failover when an application is offline).

`limit` is how many applications may share one domain on the caller's plan: 2 on Standard, 5 on Pro, 10 on Enterprise.

Served from the cached project list. Rate limited to 20 requests per 60s per user.

## Response `200`

Custom domains grouped by hostname. Empty array when no application has a custom domain.

- object
  - `status` 'success', required
  - `response` object, required
    - `limit` integer, required — Maximum applications allowed on one domain for the caller's plan.
    - `balancers` object[], required
      - `hostname` string, required — The custom domain.
      - `apps` object[], required — Applications serving this domain.
        - `id` string, required — 24-char hex identifier of the application.
        - `name` string, required — Application name.
        - `cluster` string — Cluster currently hosting the application.

## Other responses

- `401` — The Authorization header is missing, malformed, or the credentials are not valid.
- `429` — The endpoint enforces its own rate limit and the caller hit the cooldown.
- `500` — An unexpected error occurred while processing the request.

---

[API](https://skmtc.dev/squarecloud/apis/square-cloud-api.md) · [All operations](https://skmtc.dev/squarecloud/apis/square-cloud-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/squarecloud/square-cloud-api/revisions/54b7733a6b95/schema)