FMP

FMP

Enter

Earnings Historical & Upcoming API

A list of historical & upcoming earnings announcements for a specific company, including the date, estimated EPS, and actual EPS.

About Earnings Historical & Upcoming API

The FMP Earnings Historical endpoint is a valuable tool for investors, analysts, and other individuals who need to analyze a company's past earnings performance and to identify trends. Earnings announcements can provide valuable insights into a company's financial performance and outlook. The FMP Earnings Historical endpoint is easy to use. Simply provide the ticker symbol for the company that you are interested in and the date range that you want to analyze. The endpoint will return a list of historical earnings announcements for the company. The list will include the date of the earnings announcement, the estimated EPS, and the actual EPS. The FMP Earnings Historical endpoint can be used for a variety of purposes, such as:
  • To analyze a company's past earnings performance.
  • To identify companies that are trending in the right direction.
  • To identify companies that are struggling.
  • Earnings Historical & Upcoming API Parameters

    Path Parameter

    Type

    Example

    symbol*

    string

    AAPL

    (*) Required

    Query Parameter

    Type

    Example

    limit

    number

    100

    How it works

    How-it-works Signup

    Get Started: Sign Up Today!

    Begin your data journey by signing up and accessing our API endpoints. Get instant access to a vast array of financial data to power your applications and analyses.

    How-it-works Free plan

    Dive into Data: Free Plan Access

    Explore our free data plan and access a wide range of financial data through our API endpoints. Start integrating real-time data into your applications and projects.

    How-it-works Upgrade-Premium

    Unlock Premium Data: Upgrade Now!

    Upgrade to our premium plan for exclusive access to advanced financial datasets via our API endpoints. Take your analyses to the next level and gain a competitive edge in the market.

    Related Earnings Historical & Upcoming APIs

    link-image
    Earnings Calendar

    A list of upcoming & past earnings announcements for publicly traded companies, including the date, estimated earnings per share (EPS), and actual EPS (if available). Read more

    link-image
    Earnings Confirmed

    A list of earnings announcements for publicly traded companies that have already been confirmed. Read more

    link-image
    Earnings Surprises

    A list of earnings announcements for publicly traded companies that were either positive or negative surprises. This endpoint includes the date of the earnings announcement, the estimated EPS, the act... Read more

    Earnings Historical & Upcoming API FAQs

    How can I determine if earnings data was released before or after markets open from the historical earnings data?

    You can determine if earnings data was released before or after markets open by looking at the 'time' field in the earning calendar API. If the 'time' field shows 'BMO' it means the earnings were released before markets open, and if it shows 'AMC' it means the earnings were released after markets close.

    Could you please clarify the difference between the API end points "earnings confirmed" and "earnings calendar"?

    The Earning Confirmed endpoint is a list of earnings announcements for publicly traded companies that have already been confirmed and do not return upcoming dates. The Earnings Calendar API is a list of upcoming & past earnings announcements for publicly traded companies, including the date, estimated earnings per share (EPS), and actual EPS (if available) and it's the quarterly schedule and timetable laying out individual release dates of financial reports containing performance data for publicly traded corporations.

    Why is the /earnings-calendar endpoint not returning future earnings dates?

    Future earnings data is still available through the earnings-calendar endpoint, but you’ll need to include both a from and to date in your request to retrieve it. For example: https://financialmodelingprep.com/stable/earnings-calendar?apikey=your_api_key&from=2025-04-09&to=2026-04-09 This will return earnings scheduled within the specified date range.

    Where can I find historical outstanding shares data for each stock by year?

    You can find historical outstanding shares data for each stock by year in the real-time income statement section.

    In the new stable endpoints, you removed "fiscalDateEnding" — is there a way to tell which quarter each estimate refers to?

    This was removed because the purpose of this earnings calendar is to specify the earnings release and there were a large number of questions surrounding the date presented (as it is not the same date as when it was released). This can still be found on the statements endpoint where it is better served.

    How do you handle historical data of financial statements when stock splits or reverse splits occur?

    The financial statements are handled as required by the SEC. The number of shares outstanding are directly sourced from these filings. For historical price and shares outstanding, these are adjusted to account for stock splits and reverse stock splits

    Is your data split adjusted?

    Yes, we have historical data adjusted for splits and dividends.

    Unlock Premium Financial Insights Today!

    Join Financial Modeling Prep now to access real-time data, in-depth analysis, and personalized insights tailored to your financial goals. Stay ahead of the game and make informed decisions with our comprehensive tools and dedicated support. Sign up today and take the first step towards financial success!

    Start Your Journey Now!
    FMP

    FMP

    Financial Modeling Prep API provides real time stock price, company financial statements, major index prices, stock historical data, forex real time rate and cryptocurrencies. Financial Modeling Prep stock price API is in real time, the company reports can be found in quarter or annual format, and goes back 30 years in history.
    twitterlinkedin
    2017-2025 © Financial Modeling Prep