> **For coding agents and LLMs:** This is one Social Fetch marketing page (markdown export). For API orientation start with [`/llms.txt`](https://www.socialfetch.dev/llms.txt); for auth and crawl rules use [`/agents.txt`](https://www.socialfetch.dev/agents.txt); for every operation use [`/llms-endpoints.txt`](https://www.socialfetch.dev/llms-endpoints.txt).

## This page

- **On-site (HTML):** <https://www.socialfetch.dev/platforms/yahoo-finance/calendar>
- **Markdown (.mdx) URL:** <https://www.socialfetch.dev/platforms/yahoo-finance/calendar.mdx>

---

# Yahoo Finance Calendar API

Four calendar types over a date window, one page at a time.

`GET /v1/yahoo-finance/calendar?type=earnings&from=2015-01-05&to=2015-01-10` returns `data.type`, `data.from`, `data.to`, `data.total`, `data.start`, `data.count`, `data.events` and `data.page`. Types are `earnings`, `economic`, `splits` and `ipo`; the default is `earnings`. `from` and `to` are ISO 8601 dates or times, with epoch seconds also accepted.

The window must be at most 366 days and `from` must be earlier than `to`. Page with `limit`, `offset` or the opaque `cursor` from `data.page.nextCursor`. A window with no rows is an empty page, not an error. Send `region` and `language` for the local calendar where Yahoo Finance offers one.

## Request

- **Endpoint:** `GET /v1/yahoo-finance/calendar`
- **Credits:** 1 credit
Failed requests are free
- **Input:** by type and date window
- **Full reference:** [docs](https://www.socialfetch.dev/docs/api/v1/yahoo-finance/calendar/get)
- **Platform page:** [/platforms/yahoo-finance](https://www.socialfetch.dev/platforms/yahoo-finance)

## FAQ

### Which calendar types are supported?

earnings, economic, splits and ipo, selected with type. The default is earnings.

### What date window can I request?

From and to must be ISO 8601 dates or times, with from earlier than to, and the window can be at most 366 days.

### How do I page a calendar?

Read data.page.nextCursor and pass it as cursor while data.page.hasMore is true. A page past the end returns no rows and no next cursor.

### What if a window has no rows?

data.events is empty and data.page.hasMore is false. That is a completed answer for an empty window, not a missing calendar.

### How many credits does this route cost?

Pricing is documented on the operation in the API registry (shown on this page). Confirm on every response with meta.creditsCharged: that field is the billing source of truth.