list_calendar_events
TOOLList calendar eventsscope: dataflow:calendar.read · read-only
Tool description, as exposed to the agent
Returns upcoming scheduled events for one company or the general meetings of one owner's portfolio companies. Pass exactly one of company_id (use search_securities) or owner_id (use search_owners). For a company, events include dividends, share splits, annual and extra general meetings (AGM/EGM), capital-market days, year-end and quarterly reports, and analyst meetings — each with a plain-English event label, a date, and any comment (e.g. the report period or dividend amount). For an owner, the tool returns the upcoming general meetings of the companies the owner holds, each naming the company. The days_ahead parameter sets how far forward to look (default 90, max 365); results are ordered soonest-first. Successful calls may consume Dataflow credits.Parameters
| Parameter | Type | Description | |
|---|---|---|---|
| company_id | integer | optional | Company whose upcoming calendar events to list, from search_securities. Mutually exclusive with owner_id. Nonzero integer; the sign of the ID has NO meaning. Pass it through verbatim. |
| owner_id | integer | optional | Owner whose portfolio companies' upcoming general meetings to list, from search_owners. Mutually exclusive with company_id. Nonzero integer; the sign of the ID has NO meaning. Pass it through verbatim. |
| days_ahead | integer | optional | Forward-looking window in calendar days from today (UTC). Default 90, max 365.default 90 · min 1 · max 365 |
| limit | integer | optional | Maximum number of events, ordered by date ascending (soonest first). Hard cap 50.default 20 · min 1 · max 50 |
Billing
Pricing key: calendar.events. Successful calls consume Dataflow credits per your contract. See Credits & pricing.