---
title: "List Companies"
method: GET
path: "/conglomerates/{conglomerate_id}/companies"
tags: ["companies"]
---

# List Companies

`GET /conglomerates/{conglomerate_id}/companies`

## 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/conglomerates/{conglomerate_id}/companies`
- Auth: HTTP bearer

List all non-archived companies for a conglomerate.

## Path parameters

- `conglomerate_id` string, uuid, required

## Response `200`

Successful Response

- CompanyListResponse
  - `companies` CompanyResponse[], required
    - `id` string, required
    - `conglomerate_id` string, required
    - `name` string, required
    - `handle` string, required
    - `one_liner` string, nullable
    - `mission` string, nullable
    - `initial_prompt` string, nullable
    - `status` 'draft' | 'active' | 'paused' | 'archived', required
    - `balance_cents` integer
    - `balance_real_cents` integer
    - `github_repo_url` string, nullable
    - `github_repo_full_name` string, nullable
    - `cycle_interval_seconds` integer
    - `max_daily_tasks` integer
    - `tasks_used_today` integer
    - `harness_version` number
    - `custom_domain` string, nullable
    - `custom_domain_verified` boolean
    - `email_address` string
    - `platform_email_address` string
    - `website_url` string
    - `dashboard_url` string
    - `outbound_email_paused` boolean
    - `outbound_prospect_search_paused` boolean
    - `status_emails_paused` boolean
    - `selling_paused` boolean
    - `open_ask_count` integer
    - `open_proposal_count` integer
    - `next_scheduled_run_at` string, date-time, nullable
    - `active_routine_task_ids` string[]
    - `coordinator_session_id` string, nullable
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-20** `f9255294952f`: 1 info
  - added the optional property `companies/items/coordinator_session_id` to the response with the `200` status
- **2026-09-19** `734278ef1b5b`: 2 info
  - added the optional property `companies/items/email_address` to the response with the `200` status
  - added the optional property `companies/items/platform_email_address` to the response with the `200` status
- **2026-09-11** `97b262b63810`: 3 info
  - added the optional property `companies/items/active_routine_task_ids` to the response with the `200` status
  - added the optional property `companies/items/next_scheduled_run_at` to the response with the `200` status
  - added the optional property `companies/items/open_proposal_count` to the response with the `200` status
- **2026-09-09** `1229e41b14fd`: 1 info
  - added the optional property `companies/items/open_ask_count` to the response with the `200` status
- **2026-09-08** `ce91d2efae25`: 1 info
  - added the optional property `companies/items/dashboard_url` to the response with the `200` status

[Operation history](https://skmtc.dev/nanocorp/apis/nanocorp-api/changes/conglomerates/:conglomerate_id/companies/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)