Skip to main content

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.

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

ParameterTypeRequiredDescription
start_datestringConditionalOptional. If set, end_date is required. YYYY-MM-DD HH:MM:SS, interpreted in your Space’s timezone. Filters by company creation date.
end_datestringConditionalRequired if start_date is set.
per_pageintegerNo1–5000. Default 200.
cursorstringNoPagination 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.