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

# Ottieni record DNS

> Ottieni i record DNS del tuo dominio personalizzato.

**Un dominio personalizzato deve essere già collegato all'applicazione per usare questa route.** I domini personalizzati sono disponibili a partire dal [piano Standard](https://squarecloud.app/it/pricing). Questa route ha un limite di frequenza di 3 richieste ogni 10 secondi.

<ParamField header="Authorization" type="string" placeholder="API Key" required>
  La chiave API del tuo account. Puoi trovarla nelle [impostazioni del tuo account](https://squarecloud.app/it/account/security).
</ParamField>

### Parametri

<ParamField path="app_id" type="string" placeholder="Application ID" required>
  L'ID dell'applicazione. Puoi trovarlo nell'URL della dashboard della tua applicazione.
</ParamField>

### Risposta

<ResponseField name="status" type="string">
  Indica se la chiamata è andata a buon fine. `success` in caso di successo, `error` in caso contrario.
</ResponseField>

<ResponseField name="response" type="array">
  Il contenuto della risposta.

  <Expandable title="Mostra oggetto">
    <ResponseField name="type" type="string">
      Il tipo del record DNS.
    </ResponseField>

    <ResponseField name="name" type="string">
      Il nome del record DNS.
    </ResponseField>

    <ResponseField name="value" type="string">
      Il valore del record DNS.
    </ResponseField>

    <ResponseField name="status" type="string">
      Lo stato del record DNS. Può essere `pending_validation`, `pending` o `active`.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseExample>
  ```json theme={null}
  {
    "status": "success",
    "response": [
      {
        "type": "txt",
        "name": "_acme-challenge.joaootavios.dev",
        "value": "hmo-jMx_KCWQU5CWG6xmrkI4AOZOJXlQtjEtc7zI1PA",
        "status": "pending_validation"
      },
      {
        "type": "cname",
        "name": "joaootavios.dev",
        "value": "cname.squareweb.app",
        "status": "pending"
      }
    ]
  }
  ```
</ResponseExample>