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

# Obtenir les enregistrements DNS

> Obtenez les enregistrements DNS de votre domaine personnalisé.

**Un domaine personnalisé doit déjà être rattaché à l'application pour utiliser cette route.** Les domaines personnalisés sont disponibles à partir du [plan Standard](https://squarecloud.app/fr/pricing). Cette route est limitée à 3 requêtes toutes les 10 secondes.

<ParamField header="Authorization" type="string" placeholder="API Key" required>
  La clé d'API de votre compte. Vous pouvez la trouver dans les [paramètres de votre compte](https://squarecloud.app/fr/account/security).
</ParamField>

### Paramètres

<ParamField path="app_id" type="string" placeholder="Application ID" required>
  L'ID de l'application. Vous pouvez le trouver dans l'URL du tableau de bord de votre application.
</ParamField>

### Réponse

<ResponseField name="status" type="string">
  Indique si l'appel a réussi. `success` en cas de succès, `error` sinon.
</ResponseField>

<ResponseField name="response" type="array">
  Le contenu de la réponse.

  <Expandable title="Afficher l'objet">
    <ResponseField name="type" type="string">
      Le type de l'enregistrement DNS.
    </ResponseField>

    <ResponseField name="name" type="string">
      Le nom de l'enregistrement DNS.
    </ResponseField>

    <ResponseField name="value" type="string">
      La valeur de l'enregistrement DNS.
    </ResponseField>

    <ResponseField name="status" type="string">
      Le statut de l'enregistrement DNS. Il peut être `pending_validation`, `pending` ou `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>
