get_company - Cometly API Docs

Returns the record for one company tracked in your Space: id, domain, external_id, and name. domain is null for companies identified only by a customer-supplied external_id rather than an email domain; external_id is null when the customer never supplied one. A company may carry either identifier or both.

When to use

Drilling into a single company after list_companies returns its ID.
“Tell me about company 1041.”
“What’s the domain on company 1039?”

Parameters

Parameter	Type	Required	Description
`id`	integer	Yes	The numeric ID of the company.

Example response

{
  "id": 1041,
  "domain": "acme.com",
  "external_id": null,
  "name": "Acme Corp"
}

Caveats

Returns 404 ([not_found]) if no company with that ID exists in the current Space.
external_id can be null — for a company identified only by an email domain rather than a customer-supplied external ID.
For per-contact data within a company, use list_contacts or pivot through query_ad_metrics with query_mode: "company".