---
title: "List every domain configured across the account's applications"
method: GET
path: "/v2/apps/domains"
tags: ["Network"]
---

# List every domain configured across the account's applications

`GET /v2/apps/domains`

Returns a flat list of every hostname configured across the applications owned by the caller: the default `<subdomain>.squareweb.app` hostname (`type: "subdomain"`) and any attached custom domain (`type: "custom"`). Custom domains are listed first, followed by the default subdomains. Applications without a web domain are omitted.

Served from the cached project list, so it does not count against the per-application network rate limits. Rate limited to 20 requests per 60s per user.

## Response `200`

Flat list of configured domains. Empty array when the account has no web applications.

- object
  - `status` 'success', required
  - `response` object[], required
    - `app_id` string, required — 24-char hex identifier of the application the domain belongs to.
    - `hostname` string, required — The fully qualified hostname.
    - `type` 'subdomain' | 'custom', required — `subdomain` for the default `*.squareweb.app` hostname, `custom` for an attached custom domain.

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