# Calendars

> Upcoming events: company earnings dates with estimates, economic releases with forecasts, dividends, or IPOs.

Source: https://wiseview.ai/docs/api/calendar

`GET https://api.wiseview.ai/v1/calendar`

Upcoming events: company earnings dates with estimates, economic releases with forecasts, dividends, or IPOs.

Each call counts against your allowance.

## Parameters

| Name | In | Type | What it does |
| --- | --- | --- | --- |
| `kind` (required) | query | one of the values | Which calendar. One of `earnings`, `economic`, `dividends`, `ipos`. |
| `days_ahead` | query | whole number, 1–60 | How far ahead, in days. Leave it out for `7`. |
| `my_watchlist_only` | query | true or false | Earnings only: just your watchlist names. |

## Answer

`data`, abridged — real answers carry more fields:

```json
[
  {
    "symbol": "AAPL",
    "date": "2026-10-30",
    "epsEstimated": 1.78,
    "revenueEstimated": 102000000000,
    "time": "amc"
  }
]
```

## Samples

```bash
curl "https://api.wiseview.ai/v1/calendar?kind=earnings" \
  -H "Authorization: Bearer $WISEVIEW_API_KEY"
```

```python
import os
import requests

response = requests.get(
    "https://api.wiseview.ai/v1/calendar?kind=earnings",
    headers={"Authorization": f"Bearer {os.environ['WISEVIEW_API_KEY']}"},
)
response.raise_for_status()
print(response.json())
```

```javascript
const response = await fetch("https://api.wiseview.ai/v1/calendar?kind=earnings", {
  headers: { "Authorization": `Bearer ${process.env.WISEVIEW_API_KEY}` },
});
if (!response.ok) throw new Error(`WiseView answered ${response.status}`);
console.log(await response.json());
```