> ## Documentation Index
> Fetch the complete documentation index at: https://doc.astreus.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Calendars and event research

> Earnings, economic releases, corporate events and congressional schedules with source-linked detail.

| Feed | Index | Detail |
| - | - | - |
| Earnings | `/api/v1/earnings/calendar` | `/api/v1/earnings/calendar/{id}` |
| Live earnings calls | `/api/v1/earnings/live` | Follow links returned by the live-call response |
| Economic releases | `/api/v1/economic/calendar` | `/api/v1/economic/calendar/{id}` |
| Corporate events | `/api/v1/corporate/calendar` | Use the event's source and company references |
| Congressional events | `/api/v1/congressional/calendar` | `/api/v1/congressional/calendar/{id}` |

Use `from` and `to` (YYYY-MM-DD) to define a window, and `limit`/`offset` where
supported. Preserve `nextOffset` and the applied filters while paging. Earnings
and corporate feeds accept `view=compact` to omit display-only fields; source
detail remains available through their detail or linked source routes.

Filters differ by feed: inspect the API Reference or `astreus api describe` for
the exact country/company/status filters rather than passing a filter to every
calendar and assuming it was applied. Dates can be tentative, confirmed or
inferred; retain their evidence and timing status. Empty coverage is not proof
that a company has no event. Corporate-calendar coverage is primarily sourced
from 8-Ks and is not a complete dividend ledger.

```bash theme={null}
astreus --json api list --search "earnings calendar"
astreus --json api call get-earnings-calendar-all-companies \
  --query from=2026-10-31 --query to=2026-11-07 --query limit=20
```

MCP `get_calendar` selects a feed and returns a bounded view;
`get_calendar_event` retrieves a specific event. The older `astreus calendar <company>` command reads that issuer's filing-derived event timeline; it is a
different endpoint from the cross-company calendar feeds.

Economic headlines may withhold figures whose publisher's redistribution rights
are not established for a tool. A scheduled event, a preliminary result and a
revised result represent different states; do not treat an estimate as a release.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.