> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bouncy.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Check DNS Status

> Check the current DNS configuration status for a domain

## Request

### Headers

### Path Parameters

<ParamField path="domain" type="string" required>
  The domain name to check

  **Example:** `go.example.com`
</ParamField>

## Response

<ResponseField name="domain" type="string">
  The domain name
</ResponseField>

<ResponseField name="verified" type="boolean">
  Whether the domain is verified
</ResponseField>

<ResponseField name="dnsRecords" type="object">
  Required DNS records

  <Expandable title="properties">
    <ResponseField name="type" type="string">
      Record type (e.g., "CNAME")
    </ResponseField>

    <ResponseField name="host" type="string">
      Host/Name for the DNS record
    </ResponseField>

    <ResponseField name="value" type="string">
      Expected value for the DNS record
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="currentDns" type="object">
  Current DNS configuration detected

  <Expandable title="properties">
    <ResponseField name="recordFound" type="boolean">
      Whether the DNS record was found
    </ResponseField>

    <ResponseField name="recordType" type="string">
      Type of record found
    </ResponseField>

    <ResponseField name="recordValue" type="string">
      Current value of the DNS record
    </ResponseField>

    <ResponseField name="matches" type="boolean">
      Whether current DNS matches expected configuration
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="instructions" type="string">
  Human-readable setup instructions
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl https://api.bouncy.ai/v1/domains/go.example.com/dns \
    -H "Authorization: Bearer bcy_live_pk_YOUR_API_KEY"
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch(
    'https://api.bouncy.ai/v1/domains/go.example.com/dns',
    {
      headers: {
        'Authorization': 'Bearer bcy_live_pk_YOUR_API_KEY'
      }
    }
  );

  const dnsStatus = await response.json();

  if (dnsStatus.currentDns.matches) {
    console.log('DNS is configured correctly!');
  } else {
    console.log('DNS needs configuration:');
    console.log(dnsStatus.instructions);
  }
  ```

  ```python Python theme={null}
  import requests

  response = requests.get(
      'https://api.bouncy.ai/v1/domains/go.example.com/dns',
      headers={'Authorization': 'Bearer bcy_live_pk_YOUR_API_KEY'}
  )

  dns_status = response.json()

  if dns_status['currentDns']['matches']:
      print('DNS is configured correctly!')
  else:
      print('DNS needs configuration:')
      print(dns_status['instructions'])
  ```
</RequestExample>

<ResponseExample>
  ```json 200 Configured Correctly theme={null}
  {
    "domain": "go.example.com",
    "verified": true,
    "dnsRecords": {
      "type": "CNAME",
      "host": "go",
      "value": "cname.bouncy.ai"
    },
    "currentDns": {
      "recordFound": true,
      "recordType": "CNAME",
      "recordValue": "cname.bouncy.ai",
      "matches": true
    },
    "instructions": "DNS is configured correctly and verified."
  }
  ```

  ```json 200 Needs Configuration theme={null}
  {
    "domain": "go.example.com",
    "verified": false,
    "dnsRecords": {
      "type": "CNAME",
      "host": "go",
      "value": "cname.bouncy.ai"
    },
    "currentDns": {
      "recordFound": false,
      "recordType": null,
      "recordValue": null,
      "matches": false
    },
    "instructions": "Add a CNAME record with host 'go' pointing to 'cname.bouncy.ai' in your DNS provider."
  }
  ```

  ```json 404 Not Found theme={null}
  {
    "error": {
      "code": "domain_not_found",
      "message": "Domain not found in your account"
    }
  }
  ```
</ResponseExample>