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

# List Domains

> Retrieve all custom domains connected to your account

## Request

### Headers

## Response

<ResponseField name="domains" type="array">
  Array of domain objects

  <Expandable title="properties">
    <ResponseField name="id" type="string">
      Domain ID
    </ResponseField>

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

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

    <ResponseField name="isDefault" type="boolean">
      Whether this is your default domain
    </ResponseField>

    <ResponseField name="linkCount" type="number">
      Number of links using this domain
    </ResponseField>

    <ResponseField name="createdAt" type="string">
      ISO 8601 timestamp of creation
    </ResponseField>

    <ResponseField name="verifiedAt" type="string">
      ISO 8601 timestamp of verification (null if not verified)
    </ResponseField>
  </Expandable>
</ResponseField>

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

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

  const { domains } = await response.json();
  console.log(`You have ${domains.length} custom domains`);

  domains.forEach(domain => {
    console.log(`${domain.domain} - ${domain.verified ? 'Verified' : 'Not verified'}`);
  });
  ```

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

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

  data = response.json()
  print(f"You have {len(data['domains'])} custom domains")

  for domain in data['domains']:
      status = 'Verified' if domain['verified'] else 'Not verified'
      print(f"{domain['domain']} - {status}")
  ```
</RequestExample>

<ResponseExample>
  ```json 200 Success theme={null}
  {
    "domains": [
      {
        "id": "dom_abc123",
        "domain": "go.example.com",
        "verified": true,
        "isDefault": true,
        "linkCount": 45,
        "createdAt": "2026-01-15T10:00:00Z",
        "verifiedAt": "2026-01-15T10:30:00Z"
      },
      {
        "id": "dom_def456",
        "domain": "link.example.com",
        "verified": false,
        "isDefault": false,
        "linkCount": 0,
        "createdAt": "2026-02-05T14:00:00Z",
        "verifiedAt": null
      }
    ]
  }
  ```
</ResponseExample>