Skip to main content

Get Company Angles

GET 
/v1/companies/angles

For a target company (by domain), returns who in the caller's network might be able to introduce them to employees there.

  • contacts[]: people who can introduce (from the caller's CRM contacts, or the caller themselves via a shared past employer).
  • targetEmployees[]: target-company employees reachable through those contacts, ranked by bestPathScore desc.
  • paths[]: each introduction edge — contactId → targetEmployeeId via sharedEmployer. pathType is either direct (the caller personally worked at the shared employer — they can reach out themselves) or contact (one of the caller's CRM contacts worked there — the caller should ask that contact for the intro). Prefer entries with tenuresOverlap: true (they actually worked together, not just at the same company in different eras).

When paths is empty, emptyReason names the cause — an empty answer is never "you have no connections" by default. When the target company is too large to search whole, the most senior employees are searched and coverage reports the roster size against the number actually looked at; report that to the user rather than presenting a partial search as complete.

Routes that run through a person the organization holds no record of are withheld, because there is no contact detail to act on. unreachablePathsDropped counts them, so "no route you can act on" stays distinguishable from "no route at all".

Request​

Responses​

Introduction paths into the target company