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

# List Domains

`GET /domains`

Lists the caller's domain claims and assignments. Filter by account, app, or lifecycle status.

## Query parameters

- `account_id` string
- `app_id` string
- `status` 'pending_verification' | 'provisioning' | 'active' | 'action_required' | 'deleting' | 'removed'
- `order` 'created_at' | 'updated_at'
- `direction` 'asc' | 'desc'
- `first` integer
- `after` string
- `last` integer
- `before` string

## Response `200`

Domain list

- object
  - `data` Domain[], required
    - `account_id` string, required — ID of the account claiming or owning this domain, prefixed `biz_`.
    - `app_id` string, required — ID of the app assigned to this domain, prefixed `app_`.
    - `certificate_status` string, nullable, required — Cloudflare's latest certificate issuance status.
    - `created_at` string, required — When the domain claim was created, as an ISO 8601 timestamp.
    - `dns_records` DomainDnsRecord[], required
      - `name` string, required — Full hostname where the record must be published.
      - `type` 'TXT' | 'CNAME' | 'A' | 'AAAA', required — DNS record type.
      - `value` string, required — DNS record content.
    - `dns_status` 'pending' | 'valid' | 'invalid' | 'unknown', required — Result of the most recent DNS routing check. Ownership is verified separately.
    - `domain` string, required — Normalized hostname, such as checkout.example.com.
    - `hostname_status` string, nullable, required — Cloudflare's latest hostname activation status.
    - `id` string, required — Domain ID, prefixed `dom_`.
    - `issues` DomainIssue[], required
      - `code` string, required — The source of the setup issue.
      - `message` string, required — What needs attention before the domain can serve the website.
    - `last_checked_at` string, nullable, required — When DNS and provider state were last checked, as an ISO 8601 timestamp.
    - `metadata` object, required — Custom string keys and values attached to this domain.
    - `status` 'pending_verification' | 'provisioning' | 'active' | 'action_required' | 'deleting' | 'removed', required — Domain lifecycle. Only active domains resolve to their app.
    - `updated_at` string, required — When the domain was last updated, as an ISO 8601 timestamp.
    - `verification_expires_at` string, nullable, required — When an unverified claim is automatically deleted, 48 hours after creation, as an ISO 8601 timestamp.
    - `verified_at` string, nullable, required — When Whop verified the ownership TXT record, as an ISO 8601 timestamp.
  - `page_info` object, required
    - `end_cursor` string, nullable, required
    - `has_next_page` boolean, required
    - `has_previous_page` boolean, required
    - `start_cursor` string, nullable, required

## Changes

> 70 revisions in range; 1 not diffed.

- **2026-09-16** `ff3a76573563` — 1 breaking, 2 warning
  - for the `query` request parameter `first`, default value `20` was added
  - for the `query` request parameter `first`, the max was set to `100.00`
  - for the `query` request parameter `last`, the max was set to `100.00`
- **2026-09-10** `2a25564a92d5` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/whop/apis/whop-api/changes/domains/get.md)

---

[API](https://skmtc.dev/whop/apis/whop-api.md) · [All operations](https://skmtc.dev/whop/apis/whop-api/llms.txt) · [OpenAPI document](https://skmtc.dev/whop/apis/whop-api/revisions/7fcefabddb0a?raw)