list_companies

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. For ad performance, use 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

{
  "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.

Get Started

Connecting Clients

Tools

Resources

Prompts

When to use

Parameters

Example response

Caveats

​When to use

​Parameters

​Example response

​Caveats

When to use

Parameters

Example response

Caveats