get_buyback_program
TOOLGet buyback programscope: dataflow:buyback.read · read-only
Tool description, as exposed to the agent
Returns the current active share-repurchase (buyback) program for a publicly listed company, or null if the company has no active program. A buyback program is a board-authorized commitment to buy back the company's own shares from the market over a stated period, up to a stated maximum (in shares or value). Use search_securities first to obtain the company_id. The response describes the program window (valid_from, valid_to), the authorized maximum (max_shares, max_value), how much has been repurchased so far (shares_repurchased, value_repurchased, percent of the cap), and the volume-weighted average price (vwap). Set include_inactive=true to retrieve the most recent program even if it has expired. Use list_buyback_transactions on the same company_id for the individual trades that made up the program. Successful calls may consume Dataflow credits.Parameters
| Parameter | Type | Description | |
|---|---|---|---|
| company_id | integer | required | Company whose buyback program to return, 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. |
| include_inactive | boolean | optional | When true, returns the most recent program even if it has ended (valid_to in the past). Default false — return only currently active programs.default false |
Billing
Pricing key: buyback.program. Successful calls consume Dataflow credits per your contract. See Credits & pricing.