---
title: "List Domains"
method: GET
path: "/companies/{company_id}/domains"
tags: ["domains"]
---

# List Domains

`GET /companies/{company_id}/domains`

## Request

- Base URL: `https://api.nanocorp.so` (the document declares no server; this is the origin it was published from)
- URL: `https://api.nanocorp.so/companies/{company_id}/domains`
- Auth: HTTP bearer

The company-visible slice of the conglomerate's domain pool: attached
here, parked, or bought from this company (the settings UI polls this
through order_pending → registered after returning from Stripe).

## Path parameters

- `company_id` string, uuid, required

## Response `200`

Successful Response

- DomainListResponse
  - `domains` DomainPurchaseResponse[], required
    - `id` string, required
    - `domain` string, required
    - `status` string, required
    - `attached_company` AttachedCompanyRef
      - `id` string, required
      - `name` string, required
    - `live` boolean
    - `years` integer, required
    - `price_cents` integer, required
    - `renewal_price_cents` integer, nullable
    - `expires_at` string, date-time, nullable
    - `email_status` string
    - `email_sending_enabled` boolean
    - `email_address` string, nullable
    - `email_live_at` string, date-time, nullable
    - `created_at` string, date-time, required

## Other responses

- `422`: Validation Error

## Changes

- **2026-09-19** `734278ef1b5b`: 4 info
  - added the optional property `domains/items/email_address` to the response with the `200` status
  - added the optional property `domains/items/email_live_at` to the response with the `200` status
  - added the optional property `domains/items/email_sending_enabled` to the response with the `200` status
  - added the optional property `domains/items/email_status` to the response with the `200` status

[Operation history](https://skmtc.dev/nanocorp/apis/nanocorp-api/changes/companies/:company_id/domains/get.md)

---

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