> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cometly.com/llms.txt
> Use this file to discover all available pages before exploring further.

# list_companies

> List companies tracked in your Space. Returns one row per company with id and domain.

Returns a cursor-paginated list of companies tracked in your Space. Useful for high-level rollups of which organizations are in your workspace.

## When to use

* *"What companies do we have?"*
* *"List companies added this month."*
* *"How many distinct companies signed up last week?"*

For per-person questions, use [`list_contacts`](/mcp/tools/list-contacts). For ad performance, use [`query_ad_metrics`](/mcp/tools/query-ad-metrics).

## Parameters

| Parameter    | Type    | Required    | Description                                                                                                                              |
| ------------ | ------- | ----------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
| `start_date` | string  | Conditional | Optional. If set, `end_date` is required. `YYYY-MM-DD HH:MM:SS`, interpreted in your Space's timezone. Filters by company creation date. |
| `end_date`   | string  | Conditional | Required if `start_date` is set.                                                                                                         |
| `per_page`   | integer | No          | 1–5000. Default 200.                                                                                                                     |
| `cursor`     | string  | No          | Pagination cursor from a prior response's `next_cursor`.                                                                                 |

## Example response

```json theme={null}
{
  "data": [
    { "id": 1041, "domain": "acme.com" },
    { "id": 1040, "domain": "globex.com" },
    { "id": 1039, "domain": "initech.com" }
  ],
  "next_cursor": "eyJpZCI6MTAzOX0",
  "prev_cursor": null,
  "per_page": 200
}
```

## Caveats

* **Companies don't have custom fields** — they're derived from contact email domain. There's no `custom_field_filters` parameter on this tool today.
* **Order is newest first** by `id` descending.