---
title: "List org domains"
method: GET
path: "/org-domain"
tags: ["Org domains"]
---

# List org domains

`GET /org-domain`

## Request

- Base URL: `https://api.elaichi.ai`
- URL: `https://api.elaichi.ai/org-domain`
- Auth: HTTP bearer

Lists the domains this organization has claimed, verified or not, cursor-paginated. Requires `org:manage` or `sso:view`. Claiming, verifying, editing and removing a domain all require `org:manage`.

## Query parameters

- `limit` integer
- `cursor` string

## Headers

- `X-Organization-Id` string

## Response `200`

OK

- object
  - `result` object[], required
    - `id` string: Org domain id.
    - `organization_id` string: Owning organization (`org_…`).
    - `domain` string: DNS name, lowercased (e.g. `acme.com`).
    - `verified` boolean
    - `verification_record` string, nullable: The exact DNS TXT value to publish. Present until the domain is verified, then null — the token is of no further use.
    - `default_role_id` string, nullable: Role (`role_…`) explicitly configured for domain auto-join, or null to track the default. Org Owner is refused here. Read `effective_default_role_id` to learn what a join actually grants.
    - `effective_default_role_id` string, nullable: Server-computed: the role a verified-domain auto-join really grants. Equals `default_role_id` when that is set and the role still exists; otherwise the **Member** system role, which is what the join falls back to both when nothing is configured and when the configured role has since been deleted. `null` means even that fallback is missing, so auto-join on this domain fails rather than seating anyone.
    - `sso_connection_id` string, nullable: Linked SSO connection (`sso_…`).
    - `created_at` string, date-time
    - `updated_at` string, date-time
  - `next_cursor` string, nullable, required
  - `prev_cursor` string, nullable, required

## Other responses

- `400`: Bad request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not found
- `429`: Rate limited

---

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