---
title: "List an organization's domains"
method: GET
path: "/v1/organizations/{organization_id}/domains/"
tags: ["organizations"]
---

# List an organization's domains

`GET /v1/organizations/{organization_id}/domains/`

## Request

- Base URL: `https://api.ethiack.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.ethiack.com/v1/organizations/{organization_id}/domains/`
- Auth: none declared

List the domains belonging to an organization.

A 404 is returned when the organization is outside the caller's
scope. Same documented shape and filters as ``GET /v1/domains/``,
minus ``domain_id`` and ``organization_id`` (the path carries it).

Args:
    organization_id (int): Identifier of the organization.
    db (AsyncSession): Request-scoped database session.
    context (ActiveContext): Resolved caller identity and scope.
    query (OrganizationDomainListQuery): Filters + pagination.
    pager (Paginator): Fills the response's navigation metadata.

Returns:
    DomainListResponse: The organization's domains.

## Path parameters

- `organization_id` integer, required

## Query parameters

- `page` integer
- `per_page` integer: Page size. Values above 500 are clamped to it (or rejected, per REST__PAGINATION__PER_PAGE_OVER_MAX).
- `value` string, nullable: Exact domain value (case-insensitive).
- `verified` boolean, nullable: Filter by verification status.
- `kind` 'domain_checkbox' | 'domain_dns', nullable: Restrict to one proof method: `domain_dns` (TXT record) or `domain_checkbox` (self-attestation). Both when omitted.

## Response `200`

Successful Response

- DomainListResponse: Paginated list response for both domain listings. Attributes: domains (list[DomainResponse]): The authorized, paginated domains.
  - `total` integer, nullable
  - `page` integer, nullable
  - `per_page` integer, nullable
  - `_links` object, nullable: RFC 8288 rel to URL. Always first; last unless the route opted out of counting; prev and next when applicable.
  - `domains` DomainResponse[], required
    - `id` integer, required
    - `value` string, required
    - `organization_id` integer, required
    - `verified` boolean, required
    - `kind` 'domain_checkbox' | 'domain_dns' | 'ip_ip' | 'ip_checkbox', required: Discriminator for the :class:`Verification` hierarchy. Members: DOMAIN_CHECKBOX: Domain self-attestation (:class:`DomainCheckboxVerification`). DOMAIN_DNS: Domain DNS-record proof (:class:`DomainDNSVerification`). IP_IP: CIDR proof (:class:`IpIpVerification`) — the requester's source IP must fall within the verified CIDR (system-activated). IP_CHECKBOX: CIDR self-attestation (:class:`IpCheckboxVerification`).
    - `created_at` string, date-time, required
    - `verification_token` string, nullable
    - `verification_txt_record` string, nullable

## Other responses

- `422`: Validation Error

---

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