v1
latestOpenAPI 3.0.32026-08-0615081.4 KBGet historical earnings per share data or a future earnings calendar for a stock.
Path parameters
The company's ticker symbol. If no exchange is specified, by default a US exchange will be assumed. You may embed the exchange in the ticker symbol using the Yahoo Finance or TradingView formats. Ticker Formats: (TICKER, TICKER.EX, EXCHANGE:TICKER)
Query parameters
The format parameter is used to specify the format for your data. We support JSON and CSV formats. The default format is JSON.
Retrieve a specific earnings report by date. Accepted timestamp inputs: ISO 8601, unix, spreadsheet.
The earliest earnings report to include in the output. If you use countback, from is not required. Accepted timestamp inputs: ISO 8601, unix, spreadsheet.
The latest earnings report to include in the output. Accepted timestamp inputs: ISO 8601, unix, spreadsheet.
Countback will fetch a specific number of earnings reports before to. If you use from, countback is not required.
Retrieve a specific earnings report by date and quarter. Example: 2023-Q4. This allows you to retrieve a 4th qurater value without knowing the company's specific fiscal year.
The dateformat parameter allows you specify the format you wish to receive date and time information in.
The limit parameter allows you to limit the number of results for a particular API call or override an endpoint's default limits to get more data.
The offset parameter is used together with limit to allow you to implement pagination in your application. Offset will allow you to return values starting at a certain value.
The headers parameter is used to turn off headers when using CSV output.
The columns parameter is used to limit the results and only request the columns you need. The most common use of this feature is to embed a single numeric result from one of the end points in a spreadsheet cell.
Use human-readable attribute names in the JSON or CSV output instead of the standard camelCase attribute names.