get_company_insiders
TOOLGet company insidersscope: dataflow:insider.read · read-only
Tool description, as exposed to the agent
Returns the registered insiders of a publicly listed company — the people with privileged access (board members, executives) and the entities through which they hold. Use search_securities first to obtain the company_id. Each row is an insider owner (owner_id, navigable to the ownership and insider-transaction tools) with the people registered under it: full name, role (e.g. CEO, CFO, Board Member, Chairman), and the start and (if ended) end dates of their engagement. Each person carries a stable governor_person_id you can use to track the same individual across companies. By default only current insiders are returned; set include_former=true to include people whose engagement has ended. Pair with get_insider_holdings (same company_id) for what these insiders own. Successful calls may consume Dataflow credits.Parameters
| Parameter | Type | Description | |
|---|---|---|---|
| company_id | integer | required | Company whose insiders to list, from search_securities. Nonzero integer; the sign of the ID has NO meaning; negative IDs are normal and are NOT a flag for 'unlisted', 'private', or anything else. Pass it through verbatim. |
| at | string | optional | Optional snapshot date in YYYY-MM-DD. Defaults to today UTC. Must not be in the future. |
| include_former | boolean | optional | When true, includes people whose engagement has ended (end_date in the past). Default false — only current insiders.default false |
Billing
Pricing key: insider.people. Successful calls consume Dataflow credits per your contract. See Credits & pricing.
