Radically accessible US stock fundamentals

Material Corporate Events

Returns data from the [events] table.

This table provides material corporate events sourced from SEC Form 8-K filings for more than 10,000 US public companies. Each row represents a filing date and the associated event codes reported in that filing.

For more information on the dataset and the available indicators, please review the events table on the Explorer page.

Interaction

The table is queried via the following endpoint

https://api.sharadar.com/v1.0/data/events?api_key=test-api-key

The events table supports the following query parameters.

Parameter	Description	Default	Examples
format	The format of the results to be returned.	csv	`format=json`
years	Bulk download only. History length to download: 5, 10, or full. Defaults to the longest history included in your subscription that has a published bulk file. Alias: history.	max available	`years=5`
from	Specifies the filing date from which to return data.	prior day	`from=2023-08-01`
to	Specifies the filing date to return data until.	prior day	`to=2023-08-31`
fields	The fields (table columns) to return.	all	`fields=date,ticker,eventcodes`
ticker	Returns results for the specified ticker. Multiple tickers should be separated with a comma(,).	all	`ticker=AAPL`
limit	The number of records to return.	10000	`limit=100000`
skip	The number of results to skip before returning data.	0	`skip=10000`
sort	The field used to sort the data and the sort method (asc/desc).	date.desc	`sort=date.asc`

Examples

Return all events for a ticker

https://api.sharadar.com/v1.0/data/events?api_key=test-api-key&format=csv&ticker=AAPL

Return all events in a specific date range

https://api.sharadar.com/v1.0/data/events?api_key=test-api-key&format=csv&from=2023-08-01&to=2023-08-31

Google Sheets Example

In Google Sheets, retrieve material corporate events for a single ticker (AAPL) with IMPORTDATA. You can change the query parameters (ticker, dates, fields, filters, and so on) in the same way as the Examples in the preceding section. Paste this formula into a cell (A1):

=IMPORTDATA("https://api.sharadar.com/v1.0/data/events?api_key=test-api-key&format=csv&ticker=AAPL")

Bulk Download

Download the [events] table as a compressed CSV. The API responds with a redirect to a time-limited download URL.

https://api.sharadar.com/v1.0/data/events?api_key=test-api-key&bulk=True

Use years=5, years=10, or years=full to select history length when split bulk files are published. If years is omitted, the longest history included in your subscription is used.

https://api.sharadar.com/v1.0/data/events?api_key=test-api-key&bulk=True&years=5

Example using curl (follow redirects and write the file):

curl -L -o events.csv.zip "https://api.sharadar.com/v1.0/data/events?api_key=test-api-key&bulk=True"

Check the bulk file status (name, size, last modified) without downloading:

https://api.sharadar.com/v1.0/data/events?api_key=test-api-key&status=True

Example response:

{
  "table": "events",
  "name": "events.csv.zip",
  "size": 11563711,
  "sizeLabel": "11.0 MB",
  "modified": "2026-07-16T01:04:10.044000+00:00"
}

Overview

Data Tables