---
title: "List Domains"
method: GET
path: "/v1/custom-domains"
tags: ["Custom Domains"]
---

# List Domains

`GET /v1/custom-domains`

## Request

- Base URL: `https://api.oviond.com`
- URL: `https://api.oviond.com/v1/custom-domains`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

List custom domains for the current account.

## Response `200`

Domain list

- DomainsListResponse
  - `success` true, required
  - `data` CustomDomain[], required
    - `id` string, required
    - `domain` string, required
    - `status` 'pending' | 'verifying' | 'active' | 'failed', required
    - `provider` 'cloudflare' | 'godaddy' | 'namecheap' | 'route53' | 'google' | 'squarespace' | 'unknown', nullable
    - `is_default` boolean
    - `created_at` union
      - string
      - string
    - `domain_records` object[]
      - `type` string, required
      - `name` string, required
      - `value` string, required
    - `vercel_verification` object[]
      - `type` string, required
      - `domain` string, required
      - `value` string, required
    - `dns_records` object[]
      - `type` string, required
      - `name` string, required
      - `value` string, required
  - `meta` CustomDomainsMeta, required
    - `limit` number, nullable, required
    - `used` number, required

---

[API](https://skmtc.dev/oviond/apis/oviond-backend-api.md) · [All operations](https://skmtc.dev/oviond/apis/oviond-backend-api/llms.txt) · [OpenAPI document](https://skmtc.dev/oviond/apis/oviond-backend-api/revisions/4cb0a07daf41?raw)