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

> Lista todos los hostnames configurados en tus aplicaciones, incluyendo el subdominio predeterminado squareweb.app y cualquier dominio personalizado asociado. Tiene un límite de 20 solicitudes cada 60 segundos.

<ParamField header="Authorization" type="string" placeholder="API Key" required>
  La clave de API de tu cuenta. Puedes encontrarla en la [configuración de tu cuenta](https://squarecloud.app/es/account/security).
</ParamField>

<Note>
  Este endpoint acepta tu clave de API o un token de sesión (JWT) en el encabezado `Authorization`. La autenticación es obligatoria: las solicitudes sin ella devuelven `401`.
</Note>

### Respuesta

<ResponseField name="status" type="string">
  Indica si la llamada fue exitosa. `success` si fue exitosa, `error` si no.
</ResponseField>

El array `response` es una lista aplanada de cada hostname en las aplicaciones que posees. Los dominios personalizados aparecen primero, seguidos de los subdominios predeterminados `*.squareweb.app`. Las aplicaciones sin un dominio web (por ejemplo, workers y bots) se omiten.

<Info>
  Esta lista se sirve desde la lista de proyectos en caché, por lo que **no** cuenta contra los límites de solicitudes de red por aplicación.
</Info>

<ResponseField name="response" type="array">
  La lista de hostnames.

  <Expandable title="Alternar objeto">
    <ResponseField name="app_id" type="string">
      El identificador hexadecimal de 24 caracteres de la aplicación propietaria del dominio.
    </ResponseField>

    <ResponseField name="hostname" type="string">
      El hostname completamente cualificado.
    </ResponseField>

    <ResponseField name="type" type="string">
      `"subdomain"` para el host predeterminado `*.squareweb.app`; `"custom"` para un dominio personalizado asociado.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseExample>
  ```json theme={null}
  {
    "status": "success",
    "response": [
      { "app_id": "abc123def456abc123def456", "hostname": "example.com", "type": "custom" },
      { "app_id": "abc123def456abc123def456", "hostname": "my-app.squareweb.app", "type": "subdomain" }
    ]
  }
  ```
</ResponseExample>