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

# Verify Domain

> Verify DNS configuration for a custom domain

## Request

### Headers

### Path Parameters

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

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

<Note>
  Before verifying, ensure you've configured the DNS records provided when you connected the domain.
</Note>

## Response

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

<ResponseField name="verified" type="boolean">
  Whether verification was successful
</ResponseField>

<ResponseField name="message" type="string">
  Status message
</ResponseField>

<ResponseField name="verifiedAt" type="string">
  ISO 8601 timestamp of verification (if successful)
</ResponseField>

<ResponseField name="dnsStatus" type="object">
  DNS record status details

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

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

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

<RequestExample>
  ```bash cURL theme={null}
  curl -X POST https://api.bouncy.ai/v1/domains/go.example.com/verify \
    -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/verify',
    {
      method: 'POST',
      headers: {
        'Authorization': 'Bearer bcy_live_pk_YOUR_API_KEY'
      }
    }
  );

  const result = await response.json();
  if (result.verified) {
    console.log('Domain verified successfully!');
  } else {
    console.log('Verification failed:', result.message);
  }
  ```

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

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

  result = response.json()
  if result['verified']:
      print('Domain verified successfully!')
  else:
      print(f"Verification failed: {result['message']}")
  ```
</RequestExample>

<ResponseExample>
  ```json 200 Verified theme={null}
  {
    "domain": "go.example.com",
    "verified": true,
    "message": "Domain verified successfully",
    "verifiedAt": "2026-02-06T12:05:00Z",
    "dnsStatus": {
      "recordFound": true,
      "recordValue": "cname.bouncy.ai",
      "expectedValue": "cname.bouncy.ai"
    }
  }
  ```

  ```json 200 Not Verified theme={null}
  {
    "domain": "go.example.com",
    "verified": false,
    "message": "DNS records not configured correctly",
    "verifiedAt": null,
    "dnsStatus": {
      "recordFound": false,
      "recordValue": null,
      "expectedValue": "cname.bouncy.ai"
    }
  }
  ```

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