Top companies
List your organization's top companies (B2B accounts) over a window, sortable by active users, events, last-seen, or revenue. Covers all projects in your organization unless project_id is given; requires owner/admin. Returns company_id, name, domain, events, users, last_seen, and revenue per company, with revenue in your organization's reporting currency.
Organization API Token (prefixed sk_) sent as Authorization: Bearer sk_.... Create one in Settings and grant it scopes. Server-side only.
In: header
Query Parameters
Limit results to one project (a project_id from list_projects). Omit to include every project in your organization.
^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$uuidLook-back window in days (1-365). Defaults to 30.
1 <= value <= 365Sort field. Defaults to "users".
Value in
- "users"
- "events"
- "last_seen"
- "revenue"
Maximum companies to return (1-200). Defaults to 50.
1 <= value <= 200Response Body
curl -X GET "https://example.com/companies/top"